home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / dszbg.arc / DSZBG.DOC next >
Text File  |  1991-09-03  |  117KB  |  2,774 lines

  1.  
  2.  
  3.  
  4.  
  5.                                      CONTENTS
  6.  
  7.  
  8.  
  9.       1.  INTRODUCTION..................................................   2
  10.  
  11.  
  12.       2.  PROTOCOL FILE TRANSFERS.......................................   3
  13.           2.1   Graphic File Transfer Display...........................   3
  14.           2.2   Choosing the Best Protocol..............................   4
  15.           2.3   ZMODEM-90(TM)...........................................   4
  16.           2.4   Sending files with ZMODEM...............................   6
  17.                 2.4.1   File Maintenance with ZMODEM....................   6
  18.                 2.4.2   MobyTurbo Accelerator...........................   6
  19.                 2.4.3   ZMODEM Compression..............................   6
  20.           2.5   Receiving files with ZMODEM.............................   7
  21.                 2.5.1   ZMODEM AutoDownload.............................   7
  22.                 2.5.2   Manual ZMODEM Downloads.........................   7
  23.           2.6   Tuning ZMODEM Parameters................................   7
  24.                 2.6.1   Receiver Window Size Override...................   8
  25.                 2.6.2   Terminal Multiplexers...........................   8
  26.                 2.6.3   7 Bit Environments..............................   8
  27.                 2.6.4   Manual ABORT....................................   8
  28.           2.7   XMODEM Family Protocols.................................   9
  29.                 2.7.1   TRUE YMODEM(TM).................................   9
  30.                 2.7.2   YMODEM-1k.......................................   9
  31.                 2.7.3   YMODEM with OverThruster........................   9
  32.                 2.7.4   XMODEM-1k.......................................  10
  33.                 2.7.5   XMODEM-CRC (with fallback)......................  10
  34.                 2.7.6   Classic XMODEM..................................  10
  35.                 2.7.7   Relaxed XMODEM..................................  11
  36.                 2.7.8   XMODEM with OverThruster........................  11
  37.                 2.7.9   YMODEM-g: Traditional Overdrive.................  11
  38.                 2.7.10  XMODEM Mutants Misrepresented as YMODEM.........  12
  39.                 2.7.11  Qmodem-G/Streaming XMODEM.......................  12
  40.           2.8   Transferring Files with Unix Systems....................  12
  41.                 2.8.1   Uploading Files to Unix Systems.................  13
  42.                 2.8.2   Downloading Files from Unix Systems.............  13
  43.           2.9   VAX/VMS File Transfers..................................  15
  44.                 2.9.1   Version 4 rz/sz.................................  15
  45.           2.10  GEnie File Transfers....................................  16
  46.  
  47.  
  48.       3.  FLOW CONTROL..................................................  17
  49.  
  50.  
  51.       4.  SELECTED COMMANDS.............................................  20
  52.  
  53.  
  54.       5.  OPTIONS for Protocol File Transfers...........................  28
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.       6.  NUMERIC PARAMETERS............................................  36
  65.           6.1   X/Y/ZMODEM Numeric Parameters...........................  36
  66.  
  67.  
  68.       7.  HARDWARE/SOFTWARE COMPATABILITY...............................  40
  69.           7.1   Hardware Compatibility Notes............................  40
  70.           7.2   Brain Damaged UARTS.....................................  40
  71.           7.3   Software Compatibility..................................  42
  72.  
  73.  
  74.  
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.                                   Chuck Forsberg
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.                                DSZ Manual Addendum
  128.                      (Selected Pieces of the Pro-YAM Manual)
  129.  
  130.                                  Formatted 9-4-91
  131.  
  132.                                 For DSZ Users ONLY
  133.                                 For DSZ Users ONLY
  134.                                 For DSZ Users ONLY
  135.                                 For DSZ Users ONLY
  136.  
  137.  
  138.                                        With
  139.                            Cybernetic Data Recovery(TM)
  140.                                        and
  141.                                  True YMODEM(TM)
  142.  
  143.                           Universal Line Printer Edition
  144.  
  145.  
  146.                    Copyright 1991 Omen Technology Incorporated
  147.                                All Rights Reserved
  148.  
  149.  
  150.  
  151.                            Omen Technology Incorporated
  152.  
  153.  
  154.                           The High Reliability Software
  155.  
  156.                        17505-V Northwest Sauvie Island Road
  157.                               Portland Oregon 97231
  158.                             VOICE: 503-621-3406 :VOICE
  159.                      Modem: 503-621-3746 Speed 1200,2400,9600
  160.                          Compuserve:70007,2304  GEnie:CAF
  161.                         UUCP: ...!tektronix!reed!omen!caf
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.       (C) 1990 Omen Tech Inc                                      Chapter 0
  176.  
  177.  
  178.       DSZ Manual Addendum                                 Line Printer Draft
  179.       2
  180.  
  181.       1.  INTRODUCTION
  182.  
  183.       The chapters included here are taken from the Pro-YAM manual.  Some of
  184.       the features described here do not apply to DSZ.
  185.  
  186.       DSZ does not support ZMODEM Command Download, ZMODEM Security Check,
  187.       Kermit and certain traditional protocols (WXMODEM, *LINK, MODEM7,
  188.       etc.).
  189.  
  190.       When DSZ is called from a bulletin board or other communications
  191.       program, automatic ZMODEM file download is not available.  ZMODEM
  192.       AutoDownload is available from DSZ's t command (talk/term function).
  193.  
  194.       EXAMPLE: dsz port 1 speed 2400 t -8g
  195.  
  196.  
  197.       Chapter numbers refer to chapters in the ZCOMM user's manual.
  198.  
  199.  
  200.  
  201.                 Welcome to the Rain Forest
  202.  
  203.                         (_)  /~\\
  204.                  /~\\       /   \\/\\
  205.                 /   \\ /\\  / |   \\ \\
  206.                /\\     /     \\  \\/ /|\\   \\ \\
  207.               /  \\   /       \\ / //|\\\\   \\ \\
  208.             _/_   \\_/     ___ \\ ///|\\\\\\  _\\_\\
  209.         _________________ _______  |  ________
  210.  
  211.  
  212.                                -A Usenet Signature
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.       (C) 1990 Omen Tech Inc               Chapter 1 Protocol File Transfers
  235.  
  236.  
  237.       DSZ Manual Addendum                                 Line Printer Draft
  238.       Protocol File Transfers                                              3
  239.  
  240.       2.  PROTOCOL FILE TRANSFERS
  241.  
  242.       2.1  Graphic File Transfer Display
  243.  
  244.  
  245.       [_____________________________________________________________________[
  246.       [        Professional-YAM  Copyright 1991 Omen Technology INC         [11
  247.       [                                                                     [11
  248.       [                           ZMODEM DOWNLOAD                           [11
  249.       [                                                                     [11
  250.       [   File  pcmagcb.dmp                               3 of       8      [11
  251.       [                                                                     [11
  252.       [   Current   305152  of  348160        Total  374618 of 1170323      [11
  253.       [                                                                     [11
  254.       [   This   [[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[[-               [11
  255.       [         0------------------------50------------------------100%     [11
  256.       [   Total  [[[[[[[[[[[[[[[[                                           [11
  257.       [   State  START FILENAME COMPARE DATA CORRECTING FINISH WAIT         [11
  258.       [   Throughput     9536  Retries     0   Time left    83 sec          [11
  259.       [   MODEM                Time    16:44   Elapsed Time   1:30          [11
  260.       [                                                                     [11
  261.       [                                                                     [11
  262.       [   Packet LEN   305152  TRANSPORT   COMPRESSED      DATA  BINARY     [11
  263.       [   Subpkt LEN     1024                                               [11
  264.       [              ALT-F Cancel File   ALT-B Cancel Batch                 [11
  265.       [                                                                     [11
  266.       [/////////////////////////////////////////////////////////////////////[11
  267.        111111111111111111111111111111111111111111111111111111111111111111111111
  268.  
  269.       38kbps batch file download from a Unix system.[1] ZMODEM-90(TM)
  270.       compression yields 95kbps effective speed on the PC Magazine
  271.       Compressible File benchmark.[2]
  272.  
  273.       GSZ, ZCOMM and gYAM feature a full screen graphics status display of
  274.       file transfer statistics.  The amount of information displayed depends
  275.       on the protocol and sending program.  XMODEM, CompuServe B+, and
  276.       Kermit download displays use information supplied to the estimate
  277.  
  278.  
  279.       __________
  280.  
  281.        1. Pto-YAM screen snapshot made with ALT-Z.  The resultant YAMPIC
  282.           file was renamed to YAMPIC.BIN and read in to THEDRAW.  Thedraw
  283.           output the screen contents in IBM ANSI format, which was then
  284.           typed and screen dumped to Postsctipt with SCRtoPS(TM) by Olfe
  285.           Enterprises.
  286.  
  287.        2. Page 159, April 30 1991 PC Magazine.  Several copies of the
  288.           benchmark were concatenated to provide a file long enough for
  289.           accurate timing with a stopwatch.
  290.  
  291.  
  292.  
  293.       (C) 1990 Omen Tech Inc               Chapter 2 Protocol File Transfers
  294.  
  295.  
  296.       DSZ Manual Addendum                                 Line Printer Draft
  297.       4                                              Protocol File Transfers
  298.  
  299.       command.  In the absence of a user specified throughput value, the
  300.       Time left is calculated with real time data.  Real time throughput may
  301.       be inflated for the first 5-20 kilobytes when a streaming protocol
  302.       sends data.
  303.  
  304.       On PCDOS YAM flavors, MODEM status, time of day, and call elapsed time
  305.       are displayed.  MODEM status is displayed as follows:
  306.  
  307.       x Software flow restraint (XOFF)
  308.  
  309.       X Hardware flow restraint (CTS, etc.)
  310.  
  311.       L Loss of Carrier Detect signal (CD)
  312.  
  313.       H On Hook (DTR off)
  314.  
  315.       2.2  Choosing the Best Protocol
  316.  
  317.       A file transfer protocol should have high integrity (assurance of
  318.       accurate data) and high robustness (low probability of aborting a
  319.       transfer).  And, it should be as fast as possible without compromising
  320.       reliability.
  321.  
  322.       When PC Magazine tested file transfer protocols in early 1991, they
  323.       ignored the file transfer recommendations given in this manual.  Their
  324.       ignorance slowed Pro-YAM file transfers by as much as 400 per cent.
  325.  
  326.       With many different ways to transfer files, your choice of file
  327.       transfer methods can make the difference between efficient, error free
  328.       data and slow or error prone transfers.
  329.  
  330.       The following subchapters discuss file transfer methods in more
  331.       detail.
  332.  
  333.  
  334.       2.3  ZMODEM-90(TM)
  335.  
  336.       ZMODEM was developed in 1986 for the public domain (PD) under contract
  337.       by Telenet, a major packet switched network.  Omen Technology's
  338.       commitment to file transfer technology did not stop with PD ZMODEM.
  339.       ZMODEM-90(TM) is Omen Technology's copyrighted refinement of PD
  340.       ZMODEM.  ZMODEM-90 speeds transfers with COMPRESSION and other
  341.       accelerators.  ZMODEM-90 adds frame types to support transfers in 7-
  342.       bit environments.  ZMODEM-90 sends files faster and more reliably than
  343.       PD ZMODEM.  ZMODEM-90 works in many applications where PD ZMODEM
  344.       fails.
  345.  
  346.       ZMODEM provides a greatly simplified user interface.  The file name is
  347.       entered once, and transfer options may be given to the sending
  348.       program, even those that apply to the receiver.  ZMODEM
  349.       AutoDownload(TM) allows menu and mouse driven programs to download
  350.  
  351.  
  352.       (C) 1990 Omen Tech Inc               Chapter 2 Protocol File Transfers
  353.  
  354.  
  355.       DSZ Manual Addendum                                 Line Printer Draft
  356.       Protocol File Transfers                                              5
  357.  
  358.       files and commands with no extra keyboarding required.
  359.  
  360.       ZMODEM transfers one or more files with a single command.  The size
  361.       and transfer time for each file is displayed, and the total number of
  362.       files, size, and transmission time is displayed when more than one
  363.       file remains to be sent on a command.
  364.  
  365.       Keyboarding ALT-F allows the receiver to bypass an individual file
  366.       without having to restart the batch.
  367.  
  368.       ZMODEM transfers both files and commands.  Command download allows one
  369.       of the computers to take positive control of the session.  A security
  370.       challenge (activated by ZMODEM AutoDownload(TM)) guards against Trojan
  371.       Horse messages.*
  372.  
  373.       ZMODEM file transfers can preserve the file date and the exact file
  374.       contents, unlike traditional protocols that append garbage to files.
  375.  
  376.       Streaming transmission provides full throughput over satellite links
  377.       and packet switched networks.  One of three ZMODEM streaming control
  378.       methods may be used with systems that allow the sender to monitor the
  379.       received data for error correction packets without interrupting
  380.       transmission.  ZMODEM's "block length" is the entire file!
  381.       Individually acknowledged packets support other systems.
  382.  
  383.       ZMODEM allows programs to adjust the protocol parameters for optimum
  384.       efficiency as the file is being sent.  ZMODEM-90 allows programs to
  385.       adjust character encoding for best results with a variety of systems.
  386.  
  387.       ZMODEM is immune to conditions that prevent reliable, accurate file
  388.       transfers with traditional protocols:
  389.  
  390.        + ZMODEM data transfers are protected by the Federal Standard 32 bit
  391.          CRC to assure reliable transfers.  This 32 bit CRC gives an
  392.          undetected error rate five orders of magnitude better than XMODEM's
  393.          16 bit CRC, and more than a billion times better than checksum
  394.          XMODEM.  ZMODEM uses 16 bit CRC for file transfers with programs
  395.          that do not support 32 bit CRC.
  396.  
  397.        + Most important, all ZMODEM protocol transactions are protected by
  398.          CRC.  Other protocols advertising 16 or 32 bit CRC sometimes fail
  399.          under stress because critical control messages are not CRC
  400.          protected.
  401.  
  402.       If you've ever been disconnected when a huge file transfer was almost
  403.       finished, you'll appreciate resuming/recovering the file transfer with
  404.       ZMODEM Crash Recovery Omen Technology Incorporated's Intelligent Crash
  405.       Recovery(TM) guards against file corruption during Crash Recovery
  406.       operations.  (ZMODEM r and rr options.)
  407.  
  408.  
  409.  
  410.  
  411.       (C) 1990 Omen Tech Inc               Chapter 2 Protocol File Transfers
  412.  
  413.  
  414.       DSZ Manual Addendum                                 Line Printer Draft
  415.       6                                              Protocol File Transfers
  416.  
  417.       2.4  Sending files with ZMODEM
  418.  
  419.       To send a file with ZMODEM, the command sz file1 can be given from
  420.       either the main command prompt, or from the term function via a
  421.       secondary command prompt obtained with ALT-2.  Multiple files and wild
  422.       cards may be used.
  423.  
  424.       EXAMPLE: sz file1 file2 *.lst
  425.  
  426.       Please refer to the sz and zcommand commands in Chapter 19 for more
  427.       examples and information.
  428.  
  429.  
  430.       2.4.1  File Maintenance with ZMODEM  Omen Technology ZMODEM gives you
  431.       the tools to maintain up to date files on multiple machines.  You can
  432.       use the ZMODEM n option to transfer only those files that have changed
  433.       since the last time they were transferred.  With the p option, you can
  434.       unconditionally protect files that exist on the destination system.
  435.       To update only the files you already have while skipping the rest, use
  436.       the Yn options.  You can update an entire directory subtree with the R
  437.       option.
  438.  
  439.       SEE ALSO: File Transfer Options, Chapter 20.
  440.  
  441.       2.4.2  MobyTurbo Accelerator  Standard ZMODEM escapes network control
  442.       characters.  This causes a slight drop in throughput when sending
  443.       compressed files.  When transferring compressed files over circuits
  444.       that pass all 256 8 bit codes, Moby Turbo(TM) may be used to optimize
  445.       speed.  MobyTurbo provides the raw transfer speed of YMODEM-g and
  446.       other fragile protocols without sacrificing ZMODEM's safety or
  447.       robustness.
  448.  
  449.       MobyTurbo is activated with the m option.  The m option may be used
  450.       with the sz or rz command.
  451.  
  452.       EXAMPLE: sz -m *.zip
  453.  
  454.       MobyTurbo may be used with ZMODEM AutoDownloads by adding the m option
  455.       to the adlopts string.
  456.  
  457.       EXAMPLE: set adlopts m
  458.  
  459.  
  460.       SEE ALSO: m file transfer option
  461.  
  462.       2.4.3  ZMODEM Compression  ZMODEM-90 programs support ZMODEM
  463.       compression for fast transfers of compressible files with the Z file
  464.       transfer option.  The amount of compression (and speed increase)
  465.       depends on the structure of data in the files.
  466.  
  467.       EXAMPLE: sz -Z pcmagc.dmp
  468.  
  469.  
  470.       (C) 1990 Omen Tech Inc               Chapter 2 Protocol File Transfers
  471.  
  472.  
  473.       DSZ Manual Addendum                                 Line Printer Draft
  474.       Protocol File Transfers                                              7
  475.  
  476.       SEE ALSO: Z file transfer option
  477.  
  478.       2.5  Receiving files with ZMODEM
  479.  
  480.       2.5.1  ZMODEM AutoDownload  If Z mode has been enabled (the default),
  481.       YAM's term function will detect a ZMODEM transmission, perform a
  482.       security check, and receive the file(s) automatically.  File transfer
  483.       options for ZMODEM automatic downloads may be specified with the
  484.       adlopts string parameter.
  485.  
  486.       EXAMPLE: set adlopts m requests MobyTurbo(TM) accelerator for
  487.       downloads.
  488.  
  489.  
  490.       2.5.2  Manual ZMODEM Downloads  The rz command may be also given from
  491.       a command prompt.
  492.  
  493.       SEE ALSO: rz command
  494.  
  495.       2.6  Tuning ZMODEM Parameters
  496.  
  497.       Chapter 24.2 describes a number of ZMODEM numeric parameters which may
  498.       be adjusted for extraordinary situations, or to fine tune the last 0.1
  499.       per cent of possible performance.
  500.  
  501.       The ZMODEM subpacket length (zmodem L parameter) and the ZMODEM frame
  502.       length (zmodem l parameter) deserve special mention.  People tend to
  503.       confuse these with the familiar 128 and 1024 byte block length used in
  504.       XMODEM transfers.
  505.  
  506.       When a ZMODEM frame length of 0 is specified (the default), a single
  507.       frame will span the entire file if there are no errors.  This is the
  508.       main source of ZMODEM's reputation for fast transfers.
  509.  
  510.       Setting the ZMODEM frame length to a number between 64 and 16384
  511.       restricts the frame length to that value.  At the end of each frame,
  512.       the sender stops sending and waits for an acknowledgement from the
  513.       receiver.  When set, the ZMODEM frame length corresponds in function
  514.       to the 128 or 1024 byte block length of XMODEM based protocols.
  515.  
  516.       Each ZMODEM frame consists of one or more subpackets of 32 to 1024
  517.       bytes.  Since the subpackets within a frame are sent without pause, a
  518.       short subpacket length does not exact the terrible throughput penalty
  519.       associated with short XMODEM and Kermit blocks.  In the absence of
  520.       transmission errors, a 256 byte subpacket length has about two per
  521.       cent more overhead than a 1024 byte subpacket length.  However, the
  522.       longer subpacket length does increase error recovery time.
  523.  
  524.       Professional-YAM dynamically adjusts the ZMODEM subpacket length on
  525.       the basis of transmission speed and observed error rate.  If you know
  526.       what the error rate on a particular call will be before starting a
  527.  
  528.  
  529.       (C) 1990 Omen Tech Inc               Chapter 2 Protocol File Transfers
  530.  
  531.  
  532.       DSZ Manual Addendum                                 Line Printer Draft
  533.       8                                              Protocol File Transfers
  534.  
  535.       ZMODEM file transfer, setting the zmodem L numeric parameter will
  536.       provide a small but noticeable improvement in performance, with 1024
  537.       best for clean lines and smaller numbers better for noisy lines.
  538.  
  539.       When sending files over noisy phone lines not involving networks, the
  540.       speed of error recovery may be increased by decreasing the values of
  541.       the ZMODEM t and p numeric parameters.
  542.  
  543.       Information about YMODEM and ZMODEM protocol internals is provided in
  544.       ymodem.doc and zmodem.doc, part of Omen Technology's ZMODEM
  545.       Developer's Collection.
  546.  
  547.       2.6.1  Receiver Window Size Override  Some ZMODEM senders control the
  548.       network window size to improve error recovery and/or overcome bad flow
  549.       control configuration.  The optimum size of this depends on the
  550.       average error rate on the link, information that may not be available
  551.       to the sender.  ZMODEM-90(TM) allows the receiver to specify the
  552.       window size, with the Wn option, overriding the sender's window size.
  553.  
  554.       SEE ALSO: Wn option
  555.  
  556.       2.6.2  Terminal Multiplexers  Terminal multiplexers and telnet servers
  557.       provide a semi transparent serial link to host computers.  The sz e
  558.       and m options may be used in conjunction with the xmtxesc and zmrxesc
  559.       string parameters to specify more control characters which cannot be
  560.       passed over the serial line.
  561.  
  562.       SEE ALSO: zmtxesc, zmrxesc string parameters for details
  563.  
  564.       2.6.3  7 Bit Environments  ZMODEM-90 automatically detects 7 bit
  565.       environments and adjusts accordingly.  If the environment is known to
  566.       be 7 bits, use the E option to provide 7 bit compatibility in minimum
  567.       time.
  568.  
  569.       EXAMPLE: sz -E file.doc
  570.  
  571.  
  572.       When transferring files with a large number of bytes with the 8th bit
  573.       set, the P ("pack") option may be used to optimize 7 bit encoding.
  574.  
  575.       EXAMPLE: sz -P zipfile.zip
  576.  
  577.  
  578.       2.6.4  Manual ABORT  If a ZMODEM transfer fails abruptly under
  579.       exceptional conditions the program on the remote machine may be
  580.       manually terminated by repeatedly typing Ctrl-X characters at it until
  581.       the program exits.
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.       (C) 1990 Omen Tech Inc               Chapter 2 Protocol File Transfers
  589.  
  590.  
  591.       DSZ Manual Addendum                                 Line Printer Draft
  592.       Protocol File Transfers                                              9
  593.  
  594.       2.7  XMODEM Family Protocols
  595.  
  596.       2.7.1  TRUE YMODEM(TM)  Developed in 1981, YMODEM is finding its way
  597.       into many communications programs.  With Omen Technology's Enhanced
  598.       Data Recovery(TM), YMODEM gives excellent efficiency, integrity, and
  599.       good robustness in many applications.
  600.  
  601.       True YMODEM transfers one or more files in a batch, without alteration
  602.       or added garbage characters.  True YMODEM also preserves the file date
  603.       across multiple time zones.  Professional-YAM and the Unix(TM) rb and
  604.       sb programs preserve the file modification date.[3]
  605.  
  606.  
  607.       2.7.2  YMODEM-1k  The sb k option (1024 byte blocks) may be used to
  608.       enhance throughput, especially when using timesharing systems,
  609.       satellite links, or packet networks that can support the longer
  610.       blocks.
  611.  
  612.  
  613.       EXAMPLE: sb -k *.c *.h sends all .c and .h files in the current
  614.       directory with 1024 byte blocks.[4]
  615.  
  616.       YMODEM and YMODEM-1k transfers can be received with the rb or F3
  617.       commands.
  618.  
  619.       YMODEM file transfers with Unix and VMS systems are discussed later in
  620.       this chapter.
  621.  
  622.       Some programs claim to support YMODEM but actually use XMODEM with
  623.       1024 byte blocks.  These programs do not meet the YMODEM Minimum
  624.       Requirements defined by the YMODEM protocol.
  625.  
  626.       One can use Pro-YAM's XMODEM sx -k and rc commands with these
  627.       traditional programs.
  628.  
  629.       2.7.3  YMODEM with OverThruster  YMODEM and YMODEM-1k file downloading
  630.       from networks and timesharing systems is slowed by response times.
  631.       This slowing may be significant even when 1k blocks are used.  With
  632.       some systems, one can speed up YMODEM downloads by using the o option
  633.       with the rb command to receive the file.  Because OverThruster(TM)
  634.       defeats error recovery, a line hit will usually abort a download.
  635.       OverThruster(TM) may be used with X.PC or MNP error correcting link
  636.  
  637.  
  638.       __________
  639.  
  640.        3. Controlled by the d and z numeric parameters
  641.  
  642.        4. YAM switches to 128 byte blocks at the end of a file when the
  643.           length warrants.
  644.  
  645.  
  646.  
  647.       (C) 1990 Omen Tech Inc               Chapter 2 Protocol File Transfers
  648.  
  649.  
  650.       DSZ Manual Addendum                                 Line Printer Draft
  651.       10                                             Protocol File Transfers
  652.  
  653.       level protocols.
  654.  
  655.       EXAMPLE: rb -o
  656.  
  657.  
  658.       SEE ALSO: O numeric parameter
  659.  
  660.       2.7.4  XMODEM-1k  The XMODEM-1k protocol transfers one file per
  661.       command with 1024 byte blocks and a nominal 16 bit CRC.  The file name
  662.       must be entered for both the sender and the receiver.  Programs
  663.       lacking YAM's Cybernetic Data Recovery(TM) logic are less likely to
  664.       transfer data accurately under marginal conditions.  XMODEM's use of
  665.       every possible 8 bit code limit its effectiveness in many
  666.       applications.
  667.  
  668.       The end of the file may be padded by up to 127 or 1023[5] garbage
  669.       characters.
  670.  
  671.       To send a file with XMODEM-1k: sx -k file1
  672.  
  673.       To receive a file with XMODEM-1k: rc file1
  674.  
  675.       2.7.5  XMODEM-CRC (with fallback)  The XMODEM-CRC protocol transfers
  676.       one file per command.  The XMODEM-CRC protocol requires the receiving
  677.       program to initiate an XMODEM-CRC transfer.
  678.  
  679.       The file name must be entered for both the sender and the receiver.
  680.       Even with CRC-16, programs lacking YAM's Cybernetic Data Recovery(TM)
  681.       are less likely to transfer data under marginal conditions.  XMODEM-
  682.       CRC's short data blocks and use of every possible 8 bit code limit its
  683.       effectiveness in many applications.
  684.  
  685.       The end of the file may be padded by up to 127 garbage characters.
  686.  
  687.       To send a file with XMODEM (or XMODEM-CRC): sx file1
  688.  
  689.       To receive a file with XMODEM-CRC: rc file1
  690.  
  691.       2.7.6  Classic XMODEM  The original MODEM protocol, developed by Ward
  692.       Christensen, is supported by a large and growing number of programs
  693.       operating on a variety of micros and minis.  The base level XMODEM
  694.       protocol gives good results when used over low error rate direct
  695.       telephone connections.  XMODEM's short data blocks and use of every
  696.       possible 8 bit code preclude its application in many environments.
  697.  
  698.  
  699.  
  700.       __________
  701.  
  702.        5. Some programs (including YAM) limit this padding to 127 bytes.
  703.  
  704.  
  705.  
  706.       (C) 1990 Omen Tech Inc               Chapter 2 Protocol File Transfers
  707.  
  708.  
  709.       DSZ Manual Addendum                                 Line Printer Draft
  710.       Protocol File Transfers                                             11
  711.  
  712.       File transfers with this protocol add up to 127 garbage characters to
  713.       transferred files.  The XMODEM protocol can transfer one file per
  714.       command.  The file name must be entered at both the sender and the
  715.       receiver.
  716.  
  717.       To send a file with XMODEM: sx file1
  718.  
  719.       To receive a file with Classic XMODEM: rx file1
  720.  
  721.       2.7.7  Relaxed XMODEM  Professional-YAM's XMODEM and YMODEM support
  722.       has been optimized for maximum reliability with a wide variety of
  723.       systems under a wide variety of conditions.
  724.  
  725.       The default XMODEM and YMODEM timeout parameterss are "relaxed"
  726.       timings.  They rarely need to be lengthened except under the most
  727.       sluggish of conditions.  The zmodem t, T, and p numeric parameters
  728.       (q.v.) control timeouts for XMODEM, YMODEM, and ZMODEM.  The default
  729.       values allow 10 seconds for a packet to appear and a 10 second pause
  730.       within a packet before starting error recovery.
  731.  
  732.       EXAMPLE: zmodem pt200 pp150  :: Set more relaxed X/Y/ZMODEM timing
  733.  
  734.  
  735.       For best reliability, Omen Technology does not recommend tightening
  736.       these timings for XMODEM and YMODEM transfers on noisy lines.
  737.  
  738.       2.7.8  XMODEM with OverThruster  XMODEM file downloading from networks
  739.       and timesharing systems is slowed by short blocks and long response
  740.       times.  With some systems, one can speed up downloads by using the ro
  741.       command to receive the file.  Because OverThruster(TM) defeats error
  742.       recovery, a line hit will usually abort a download.  With nearly error
  743.       free connections, one can save enough time from the increased
  744.       throughput to make up for the failed transfers.  OverThruster(TM) may
  745.       be used with X.PC or MNP error correcting link level protocols.
  746.  
  747.       EXAMPLE: ro file1
  748.  
  749.  
  750.       EXAMPLE: rb -o
  751.  
  752.  
  753.       SEE ALSO: O numeric parameter
  754.  
  755.       2.7.9  YMODEM-g: Traditional Overdrive  The proliferation of error
  756.       correcting modems has sparked a proliferation of YMODEM-g programs,
  757.       more and more of which actually meet minimal YMODEM protocol
  758.       specifications.
  759.  
  760.       YMODEM-g transmits 0 or more files per batch with an ACK-less variant
  761.       of YMODEM-1k.  The sender does not wait for individual data blocks to
  762.       be acknowledged, allowing high speed transfers with error correcting
  763.  
  764.  
  765.       (C) 1990 Omen Tech Inc               Chapter 2 Protocol File Transfers
  766.  
  767.  
  768.       DSZ Manual Addendum                                 Line Printer Draft
  769.       12                                             Protocol File Transfers
  770.  
  771.       modems.
  772.  
  773.       YMODEM-g assumes an error free communications channel.  A single
  774.       transmission error or character lost because of DOS or TSR interrupt
  775.       latency ruins the entire transfer, and YMODEM-g does not support Crash
  776.       Recovery(TM).
  777.  
  778.       YAM supports True YMODEM-g with the sb and rb -g commands.
  779.  
  780.       EXAMPLE: sb *.old Sends files in the current directory with YMODEM or
  781.       YMODEM-g protocol.  The receiver controls whether YMODEM or YMODEM-g
  782.       is used for the transfer.
  783.  
  784.  
  785.       EXAMPLE: rb -g Receives with YMODEM-g protocol.
  786.  
  787.  
  788.       2.7.10  XMODEM Mutants Misrepresented as YMODEM  Despite continuing
  789.       education efforts, a few lazy software providers insist on identifying
  790.       their mutant XMODEM protocols as "ymodem".  They choose to ignore the
  791.       definition of YMODEM that Ward Christensen wrote when he coined the
  792.       term YMODEM in his April 1985 message:
  793.  
  794.          (a) a record 0 containing filename date time and size
  795.          (b) a 1K block size option
  796.          (c) CRC-16.
  797.  
  798.       Use the XMODEM sx-k and rc commands to deal with these nonstandard
  799.       programs.
  800.  
  801.       In case of questions, please refer to ymodem.doc, part of yzmodem.zoo
  802.       for for the official YMODEM protocol.  (Available in Omen's ZMODEM
  803.       Developer's Collection.)
  804.  
  805.       2.7.11  Qmodem-G/Streaming XMODEM  The Qmodem program and certain
  806.       bulletin boards provide an ACKless XMODEM mutant protocol selected
  807.       with the Qmodem G protocol menu choice.
  808.  
  809.       The sx and rx -g commands support this mutant XMODEM.
  810.  
  811.       EXAMPLE: rx -g qmodem.fil
  812.  
  813.  
  814.       2.8  Transferring Files with Unix Systems
  815.  
  816.       Some Unix systems are accessed via a port multiplexer or other
  817.       network.  Some of these networks interfere with data transmission.
  818.       These systems may require additional control characters to be escaped.
  819.       The sz command e option may be used to escape all control characters.
  820.  
  821.       SEE ALSO: e option
  822.  
  823.  
  824.       (C) 1990 Omen Tech Inc               Chapter 2 Protocol File Transfers
  825.  
  826.  
  827.       DSZ Manual Addendum                                 Line Printer Draft
  828.       Protocol File Transfers                                             13
  829.  
  830.       Individual control characters can be escaped with the zmtxesc string
  831.       parameter.
  832.  
  833.       SEE ALSO: zmtxesc string parameter
  834.  
  835.       2.8.1  Uploading Files to Unix Systems  Files may be uploaded to Unix
  836.       systems conveniently and quickly with ZMODEM.  Unix flavors of
  837.       Professional-YAM support the full ZMODEM-90(TM) feature set including
  838.       Intelligent Crash Recovery(TM) and selective transfers with the rz
  839.       command, a hard link to the /usr/bin/yam program.
  840.  
  841.       If the Unix system is operating with 7 bits, the sender's zmodem d
  842.       parameter may have to be increased to allow the rz program time to
  843.       change Unix to 8 bits for the transfer.
  844.  
  845.       SEE ALSO: zmodem d numeric parameter
  846.  
  847.       Professional-YAM is the fastest Unix ZMODEM upload program.  Pro-YAM
  848.       uses a minimum of CPU resources for uploads.  Pro-YAM provides the
  849.       best ZMODEM technology and feature set available., but it may not be
  850.       available on a particular system.  The rz program, part of the rzsz
  851.       package, may be used to support a subset of Pro-YAM's ZMODEM features.
  852.  
  853.       If rz is not installed on the Unix system, unpack the rzsz.zoo file on
  854.       your MSDOS system with: booz x rzsz.zoo given from the DOS prompt.[6]
  855.       Next, the command source zupl.t calls the zupl.t script to upload the
  856.       bootstrap file minirb.c, compile it, and use it to upload the
  857.       remainder of the source files.  After the rest of the files have been
  858.       uploaded, compile rz.c and sz.c using the directions given in the
  859.       README file and in the C source files.
  860.  
  861.       The rz and sz manual pages may be formatted with a make doc command.
  862.  
  863.       The undos program may be used to remove carriage returns files
  864.       uploaded to Unix machines.
  865.  
  866.       2.8.2  Downloading Files from Unix Systems  To download files from
  867.       Unix(TM) systems, use the Unix sz command to send the desired files to
  868.       YAM.  To Unix keyboard: sz file ...  Professional-YAM's ZMODEM
  869.       AutoDownload(TM) takes care of the rest for you, saving unnecessary
  870.       keystrokes.
  871.  
  872.       If one or more of the files already exists on the destination disk,
  873.  
  874.  
  875.       __________
  876.  
  877.        6. On Unix systems with Professional-YAM installed, the rzsz source
  878.           files and man pages are installed in the /usr/src/command/rzsz
  879.           directory.
  880.  
  881.  
  882.  
  883.       (C) 1990 Omen Tech Inc               Chapter 2 Protocol File Transfers
  884.  
  885.  
  886.       DSZ Manual Addendum                                 Line Printer Draft
  887.       14                                             Protocol File Transfers
  888.  
  889.       use sz -y file ...  instead, to replace the old copies on your
  890.       computer.
  891.  
  892.       Another useful option sends only the files that exist on both
  893.       computers (Y), and furthermore sends only those that are newer (n):
  894.       sz -Yn file ...
  895.  
  896.       When files are long and transmission slow, you can save time by
  897.       squeezing them first with sq.  Source for a Unix compatible version of
  898.       sq is available in xsq.cq.[7] The zoo program, available for DOS and
  899.       Unix, may also be used to compress file(s) before transmission.
  900.  
  901.       Omen Technology products support ZMODEM compression with the Z option.
  902.       All Omen Technology products support compression by Run Length
  903.       Encoding (RLE).  Unix flavors of Professional-YAM also support LZW
  904.       compression.
  905.  
  906.       Unix source files normally do not contain carriage returns used by
  907.       CP/M and DOS.  Some CP/M or DOS programs, such as C compilers, do not
  908.       require carriage returns in the source files.  Others, such as the
  909.       Microsoft Macro Assembler, become quite confused by such files,
  910.       although such files fully meet the requirements of the ASCII standard.
  911.  
  912.       Carriage Returns may be added before downloading with the todos or
  913.       tocpm programs.  Carriage returns may be added during the transfer
  914.       with the sz a option.  Carriage Returns may be added after the
  915.       transfer by some program editors, including uEMACS.  (Other editors,
  916.       such as DOS edlin may crash trying to edit such files.) Short files
  917.       (less than 64kb) may be converted using YAM's read and create commands
  918.       to pass the data through YAM's capture buffer.
  919.  
  920.       Text files may also be downloaded using the capture buffer if sz has
  921.       not been installed on the Unix machine.
  922.  
  923.       If a file or set of files are to be transported between two Unix
  924.       systems, it may be helpful to place them in a tar or cpio archive (and
  925.       possibly squeeze the archive) before transmission.  This procedure
  926.       will preserve the Unix file modes and modification times, and bypass
  927.       pathname restrictions imposed by DOS.
  928.  
  929.       As with rz, Unix Professional-YAM is linked to sz to support the full
  930.       ZMODEM-90(TM) feature set.  Otherwise the separate Unix sz program may
  931.       be obtained as described in the previous subchapter.
  932.  
  933.  
  934.  
  935.  
  936.       __________
  937.  
  938.        7. /usr/src/cmd/xsq.c on Unix systems.
  939.  
  940.  
  941.  
  942.       (C) 1990 Omen Tech Inc               Chapter 2 Protocol File Transfers
  943.  
  944.  
  945.       DSZ Manual Addendum                                 Line Printer Draft
  946.       Protocol File Transfers                                             15
  947.  
  948.       2.9  VAX/VMS File Transfers
  949.  
  950.       Most of the comments made above about Unix file transfers apply to VMS
  951.       as well.  Many VAX/VMS systems attach terminals with terminal
  952.       multiplexers just as nasty as those used with Unix systems.  They
  953.       require fixes similar to those described above for Unix systems..
  954.  
  955.       Automatic uploads to VMS may require setting the zmodem d (delay)
  956.       numeric parameter to give time for the VMS rz program to properly
  957.       initialize.
  958.  
  959.       SEE ALSO: zmodem d numeric parameter
  960.  
  961.       EXAMPLE: zmodem pd15
  962.  
  963.  
  964.       2.9.1  Version 4 rz/sz  Omen provides VMS flavors of version 4 rz and
  965.       sz precompiled in rzsz.tlb, a VMS "text library".  Version 4 rz
  966.       supports most ZMODEM-90 features including Crash Recovery,
  967.       compression, and MobyTurbo.  Binary uploads write files with a default
  968.       VMS 512 byte fixed length record format.
  969.  
  970.       EXAMPLE: sz biglib.tlb
  971.  
  972.  
  973.       Sending to VMS with the i option selects the VMS Stream_LF record
  974.       format.  Stream_LF preserves the exact file length and data contents
  975.       when read by C programs.
  976.  
  977.       EXAMPLE: sz -i vmsemacs.exe
  978.  
  979.  
  980.       Sending to VMS with the I option causes the VMS receiver to use
  981.       variable length binary records.  VMS Kermit-32 and some other programs
  982.       understand this record format.
  983.  
  984.       Text files uploaded with the a option are written in variable length
  985.       records with CR carriage control.
  986.  
  987.       EXAMPLE: sz -a emacs*.c
  988.  
  989.  
  990.       Version 4 VMS sz supports standard VMS wild card and directory
  991.       recursion syntax.
  992.  
  993.       EXAMPLE: $ sz -qa [*...]*.prn sends all accessible .prn files on the
  994.       system in ASCII mode. The VMS sz q option suppresses the initial tally
  995.       of the number of files and their lengths.  This tally can take some
  996.       time when a large number of files and directories are invloved.  The f
  997.       option may be added to send directory names as well.
  998.  
  999.  
  1000.  
  1001.       (C) 1990 Omen Tech Inc               Chapter 2 Protocol File Transfers
  1002.  
  1003.  
  1004.       DSZ Manual Addendum                                 Line Printer Draft
  1005.       16                                             Protocol File Transfers
  1006.  
  1007.       If you use Kermit to upload the rzsz.tlb file to VMS, command the
  1008.       receiving Kermit program to SET FILE TYPE FIXED.  Otherwise Kermit
  1009.       will garble the data.
  1010.  
  1011.       2.10  GEnie File Transfers
  1012.  
  1013.       The General Electric Consumer Information Service service (GEnie) uses
  1014.       ZMODEM-90(TM) for efficient downloads.  GEnie's ZMODEM server selects
  1015.       ZMODEM RLE Compression or MobyTurbo(TM) for optimum download speed on
  1016.       each file.
  1017.  
  1018.       GEnie uses a large network to provide callers with local access
  1019.       numbers.  This requires technical tradeoffs to control data flow in
  1020.       the network.  If you are using an MNP modem, download speeds can be
  1021.       improved by increasing GEnie's ZMODEM window size.
  1022.  
  1023.       EXAMPLE: C> set dszopt=W16384
  1024.  
  1025.  
  1026.  
  1027.       The sx file.exe command is used for XMODEM-CRC uploads to GEnie.  When
  1028.       uploading with XMODEM-CRC, Wait for GEnie's "READY FOR INPUT, start
  1029.       your XMODEM upload." message, and then wait for the XMODEM-CRC C to
  1030.       appear before issuing the sx command.  Issuing the sx command before
  1031.       the C appears may corrupt the uploaded file.
  1032.  
  1033.       A number of GEnie access scripts are provided in scripts.zoo with
  1034.       filenames starting with ge.  The main GEnie login script is provided
  1035.       in phones2.t witin scripts.zoo.
  1036.  
  1037.                       //-n-\\
  1038.               _____---=======---_____
  1039.           ====____\   /.. ..\   /____====
  1040.         //         ---\__O__/---        \\
  1041.         \_\                            /_/
  1042.  
  1043.           Enterprise... Surrender or we'll
  1044.           send back your *&^$% tribbles !!!
  1045.               -A Usenet Signature
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.       (C) 1990 Omen Tech Inc                          Chapter 2 Flow Control
  1061.  
  1062.  
  1063.       DSZ Manual Addendum                                 Line Printer Draft
  1064.       Flow Control                                                        17
  1065.  
  1066.       3.  FLOW CONTROL
  1067.  
  1068.       All of us must sometimes tell people to "slow down" lest they overload
  1069.       us with information faster than we can write it down.  "Wait!" is a
  1070.       Flow Control Signal for the English language.  When the receiving
  1071.       Pro-YAM complains about Garbled Data Subpacket or Line Status Register
  1072.       01 you should suspect a flow control problem.
  1073.  
  1074.       When buffered modems, timesharing systems, networks, or computers of
  1075.       differing speeds are involved, a machine readable "Wait!" signal is
  1076.       required.
  1077.  
  1078.       Flow control is sometimes necessary to display long messages without
  1079.       skipping over the good parts.  If you see pieces of text missing from
  1080.       messages but don't see the usual funny characters caused by line
  1081.       noise, ypu have a flow control problem.
  1082.  
  1083.       File transfers that use long blocks or streaming protocols may not
  1084.       work well unless slower parts of the system regulate the speed of
  1085.       transmission to prevent loss of data.  With ZMODEM, SuperKermit, and
  1086.       other streaming protocols, inexplicable retransmissions of data
  1087.       blocks, often at regular intervals, indicate flow control failure.
  1088.  
  1089.       If you wish to keep things simple, the sending computer should not
  1090.       operate at a higher interface speed than the slowest link in the
  1091.       network.  Otherwise precautions must be taken to prevent data loss
  1092.       with interactive operations and unnecessary retransmissions with
  1093.       streaming file transfer protcols.
  1094.  
  1095.       YAM, ZCOMM, and DSZ default to software flow control with XON and XOFF
  1096.       characters.[1] When used with modems that require hardware flow
  1097.       control, the handshake command (q.v.) should be used to specify which
  1098.       hardware lines are to be used for flow control.
  1099.  
  1100.       Non transparent software flow control is incompatible with Emacs
  1101.       editors, XMODEM and YMODEM transfers.  XMODEM and YMODEM require
  1102.       complete transparency to all 256 8 bit codes.  An XMODEM transfer that
  1103.       always fails at the same block results from non transparent flow
  1104.       control.  When XMODEM-1k and YMODEM-1k are used, the network must
  1105.       assert flow control, or handle bursts of 1040 characters without data
  1106.       loss.  When X.25 or hardware CTS is unavailable, flow control that
  1107.       does not "eat" any characters may be used with XMODEM and YMODEM.
  1108.       When buffers fill up, an XOFF should be emitted.  An XON should be
  1109.  
  1110.  
  1111.       __________
  1112.  
  1113.        1. The PCDOS flavor enables "handshake both" when selecting a port
  1114.           with an active Clear To Send (CTS) signal that was previously
  1115.           initialized to a speed greater than 2400 bps
  1116.  
  1117.  
  1118.  
  1119.       (C) 1990 Omen Tech Inc                          Chapter 3 Flow Control
  1120.  
  1121.  
  1122.       DSZ Manual Addendum                                 Line Printer Draft
  1123.       18                                                        Flow Control
  1124.  
  1125.       sent when the buffer has emptied.  Otherwise, the network should
  1126.       neither generate nor eat XON or XOFF characters.
  1127.  
  1128.       On Telenet, this is obtained by setting CCIT X3 5:1 and 12:1 in the
  1129.       PADs (Packet Assembler Dissassembler) at both ends of the network.
  1130.       Packets should be forwarded when the packet is a full 128 bytes, or
  1131.       after a moderate delay (3:0,4:10).  Set parameter 5 to 1 at both ends
  1132.       AFTER one is connected to the remote modem.  (Sorry, these commands
  1133.       must be given each time you connect to a modem in the far city!)
  1134.            <ENTER>@<ENTER>
  1135.            set 5:1<ENTER>
  1136.            rst? 5:1<ENTER>
  1137.            cont<ENTER>
  1138.       ZMODEM and Kermit protect all 4 XOFF and XON characters, commonly used
  1139.       network control characters and trigger strings.  ZMODEM and Kermit are
  1140.       compatible with many networks that do not support XMODEM family
  1141.       protocols, including some that claim network compatibility.  For PADs
  1142.       that do not accept "rst?", use:
  1143.            <ENTER>@<ENTER>
  1144.            set 4:2,5:1,12:1<ENTER>
  1145.            cont<ENTER>
  1146.       For best Telenet download throughput, parameter 64 (advance ACK)
  1147.       should be set to 7.  The parameter 0 is a dummy argument that
  1148.       distinguishes Telenet parameters from CCIT parameters.
  1149.            <ENTER>@<ENTER>
  1150.            set 0:0,64:7<ENTER>
  1151.            cont<ENTER>
  1152.       Sometimes Telenet flow control stops data transmission when the
  1153.       network buffers are not yet full.  If you often see "STOPPED" flashing
  1154.       in the status line (DOS versions), or if you see the modem send data
  1155.       light pause in a ZMODEM or SuperKermit file send, poor flow control
  1156.       may be the culprit.  Such slowdowns are typical when a network is
  1157.       overloaded.  If this condition persists, the network should take steps
  1158.       to reduce the congestion.  Turning OFF network flow control and
  1159.       activating ZMODEM's or SuperKermit's protocol flow control may
  1160.       increase throughput under these conditions.
  1161.  
  1162.       Instead of or in addition to XON/XOFF flow control, the sending
  1163.       program's ZMODEM w numeric parameter can restrict the window size to a
  1164.       value that does not overload the network.  A zmodem pw2048 command
  1165.       restricts the window size (maximum number of bytes in transit) to
  1166.       2048.  This causes the sz command to trigger the receiver's
  1167.       acknowledgement every 512 bytes (one fourth the value of the ZMODEM w
  1168.       numeric parameter).  The sender monitors these responses and suspends
  1169.       transmission when necessary to restrict the window to the specified
  1170.       size.  Until a network dependent lower limit is reached, lower window
  1171.       sizes improve the speed of error recovery at the expense of slight
  1172.       increases in protocol overhead.  When the window size becomes less
  1173.       than the number of characters sent within the network's transit time,
  1174.       throughput falls off rapidly.  Frequent protocol acknowledgements slow
  1175.       down high speed psuedo full duplex modems (US Robotics HST, Telebit
  1176.  
  1177.  
  1178.       (C) 1990 Omen Tech Inc                          Chapter 3 Flow Control
  1179.  
  1180.  
  1181.       DSZ Manual Addendum                                 Line Printer Draft
  1182.       Flow Control                                                        19
  1183.  
  1184.       TrailBlazer) and should be avoided.
  1185.  
  1186.       ZMODEM-90(TM) allows the receiver to specify the window size with the
  1187.       -Wn option where n is the desired window size.
  1188.  
  1189.       EXAMPLE: set adlopts W8192 requests an 8193 byte window size.
  1190.  
  1191.  
  1192.       Some modems and networks can be configured to flush (discard the
  1193.       contents of) their buffers when a break signal is received.  If this
  1194.       is possible, error recovery with ZMODEM transfers may be speeded up by
  1195.       setting the ZMODEM b parameter to 1, which sends a break whenever the
  1196.       ZMODEM sending program gets a retransmission request.
  1197.                    Network and Flow Control (FC) Compatibility
  1198.  
  1199.       ______________________________________________________________________
  1200.       |    Network     | Interactive | XMODEM | WXMODEM | S-KERMIT | ZMODEM |
  1201.       |________________|_____________|________|_________|__________|________|
  1202.       |No Network      | YES         | YES    | YES     | YES      | YES    |
  1203.       |8 bit, no FC    | NO          | YES    | YES     | YES(1)   | YES(1) |
  1204.       |Transparent FC  | YES         | YES    | YES     | YES      | YES    |
  1205.       |Non Transparent | YES         | NO     | NO      | YES      | YES    |
  1206.       |7 bit           | YES         | NO     | NO      | YES      | YES(2) |
  1207.       |________________|_____________|________|_________|__________|________|
  1208.  
  1209.       (1) Window size must be restricted to avoid buffer overrun if the
  1210.       network cannot transfer data at full speed.
  1211.       (2) Requires ZMODEM-90(TM) 7-bit support
  1212.  
  1213.  
  1214.  
  1215.  
  1216.  
  1217.  
  1218.  
  1219.  
  1220.  
  1221.  
  1222.  
  1223.  
  1224.  
  1225.  
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.       (C) 1990 Omen Tech Inc                     Chapter 3 Selected Commands
  1238.  
  1239.  
  1240.       DSZ Manual Addendum                                 Line Printer Draft
  1241.       20                                                   Selected Commands
  1242.  
  1243.       4.  SELECTED COMMANDS
  1244.  
  1245.       Commands and arguments must be entered in lower case except where
  1246.       stated.
  1247.  
  1248.       estimate length speed Use the specified length and specified effective
  1249.         speed for the next receive file to be created.  A length of 0
  1250.         bypasses the length substitution.  Once a speed (in effective bits
  1251.         per second) is given, it is used for all locally displayed
  1252.         transmission time calculations until the next speed or port command.
  1253.  
  1254.         EXAMPLE: "speed 19200; estimate 0 2400" Use an effective
  1255.         transmission speed of 2400 for transmission time estimates instead
  1256.         of the 19200 bps interface speed.
  1257.  
  1258.  
  1259.       HAndshake {off|on|cts|dsr|dcd|both|slow} Some modems and printers
  1260.         cannot accept continuous full speed data.  These devices send
  1261.         control characters (XOFF and XON) for flow control, or generate a
  1262.         hardware flow control signal on the CTS, DSR, or DCD pin.  The
  1263.         Handshake command controls the modem port hardware handshake
  1264.         (default off).
  1265.  
  1266.         If hardware handshaking is selected, an ON to OFF transition on the
  1267.         specified line pauses transmission, and an XON character will not
  1268.         override the hardware restraint.
  1269.  
  1270.         After a timeout set by the S numeric parameter (default 60 seconds),
  1271.         or if characters are in the keyboard input buffer, a warning message
  1272.         is displayed, the restraint is released, and characters are sent.
  1273.  
  1274.         As a special case, handshake on obeys output flow control with the
  1275.         CTS input signal, asserts input flow control with the RTS output
  1276.         signal, and disables the transmission of XOFF characters when the
  1277.         modem input buffer becomes nearly full.  In addition, handshake slow
  1278.         drops the RTS output signal while writing to disk when receiving
  1279.         with XMODEM, YMODEM, or ZMODEM.
  1280.  
  1281.         The command handshake both allows either CTS or XOFF to pause
  1282.         output, in addition to asserting input flow control with the RTS
  1283.         output.
  1284.  
  1285.         The handshake dcd command enables d mode (q.v.).  Subsequently,
  1286.         selecting a different type of handshaking will disable d mode.
  1287.  
  1288.         The handshake command releases flow control (allows data to flow if
  1289.         it had been stopped by handshaking).
  1290.  
  1291.         Changing the communcations port with the port or portx command
  1292.         disables hardware handshaking.
  1293.  
  1294.  
  1295.  
  1296.       (C) 1990 Omen Tech Inc                     Chapter 4 Selected Commands
  1297.  
  1298.  
  1299.       DSZ Manual Addendum                                 Line Printer Draft
  1300.       Selected Commands                                                   21
  1301.  
  1302.         SEE ALSO: S numeric parameter
  1303.  
  1304.         EXAMPLE: handshake cts Turns on CTS handshaking.
  1305.  
  1306.  
  1307.       picture (DOS versions only) Append the contents of the display screen
  1308.         to a DOS file.  The pathname is contained in the picture string
  1309.         parameter.  The exact contents of the screen memory are written to
  1310.         the file, with each screen character followed by its attribute.  A
  1311.         separate program, unpic is used to convert the screen dump to a
  1312.         normal file that may be printed or displayed.
  1313.  
  1314.         SEE ALSO: picture string parameter, unpic program
  1315.  
  1316.  
  1317.       port n Change the modem port to COMn.  On DOS, the legal values for n
  1318.         are 1...18.
  1319.  
  1320.         Selecting a new port normally selects software handshaking
  1321.         ("handshake sw").  The PCDOS flavor enables both hardware and
  1322.         software handshaking ("handshake both") iff the port speed exceeds
  1323.         2400 bps and the Clear To Send (CTS) signal is active at the time
  1324.         the port command is given.
  1325.  
  1326.         Standard Ports (PCDOS):
  1327.         COM1            3F8 IRQ4 (Standard IBM)
  1328.         COM2            2F8 IRQ3 (Standard IBM)
  1329.  
  1330.         NON STANDARD PORTS:
  1331.         COM3            3E8 IRQ4 (Alternate)
  1332.         COM4            2E8 IRQ3 (Alternate)
  1333.         COM5            2B8 IRQ3 (Columbia)
  1334.         COM6            2B8 IRQ2 (Alternate for IBM)
  1335.  
  1336.         COM7            2E8 IRQ5 (Alternate "COM3")
  1337.         COM8            3E8 IRQ5 (Alternate "COM4")
  1338.  
  1339.         COM9            Uses the port address and interrupt vector
  1340.         previously set by the portx command.
  1341.         COM11-COM18 IBM PS/2 COM1-COM8 ports
  1342.  
  1343.         COM1 and COM2 are the standard serial ports defined by the IBM
  1344.         Technical Reference Manual.
  1345.  
  1346.         COM3 and COM4 are supported by many serial cards and modem boards.
  1347.         COM3 and COM1 share the same dedicated hardware interrupt line, and
  1348.         these ports may not be used at the same time.  Likewise, COM4 and
  1349.         COM2 may not be used at the same time.
  1350.  
  1351.         Columbia computers support COM5.
  1352.  
  1353.  
  1354.  
  1355.       (C) 1990 Omen Tech Inc                     Chapter 4 Selected Commands
  1356.  
  1357.  
  1358.       DSZ Manual Addendum                                 Line Printer Draft
  1359.       22                                                   Selected Commands
  1360.  
  1361.         COM6 to COM8 are alternate configurations that may be accessed by
  1362.         cross jumpering between printer port decoders and serial port
  1363.         enables on some multifunction boards.
  1364.  
  1365.         COM7 and COM8 support alternative definitions for "COM3" and "COM4"
  1366.         respectively.
  1367.  
  1368.         COM11 to COM18 correspond to "COM1" to "COM8" on IBM PS/2 computers.
  1369.         Only one of COM12-COM18 may be used at a time unless using the
  1370.         special OS/2 comm driver for that board.
  1371.  
  1372.         Since YAM uses the interrupt line on the selected port, no other
  1373.         program or device driver may use the same port address and/or
  1374.         interrupt vector concurrently.  Certain disk controllers and mice
  1375.         interfaces use IRQ2 and IRQ5.  Do not use IRQ2 on a PC-AT (the extra
  1376.         8259 is not reset).  IRQ5 is sometimes used by network cards and
  1377.         printer ports.  Do not select COM3 to COM18 unless you are familiar
  1378.         with the I/O addresses and interrupt vectors used in your machine.
  1379.         Ports sharing the same interrupt vector (IRQ number) cannot be used
  1380.         concurrently.
  1381.  
  1382.         The port command sets the d mode (which suppress the No Carrier
  1383.         Detect message).
  1384.  
  1385.         EXAMPLE: port 2
  1386.  
  1387.  
  1388.         DOS YAM begins with COM1 unless overridden by the DPORT environment
  1389.         variable.
  1390.  
  1391.         EXAMPLE: C>set DPORT=2
  1392.  
  1393.  
  1394.         On Unix, the argument of the port command is a character special
  1395.         file in the /dev directory.  Unix and Xenix flavors have no default
  1396.         port.  If the DPORT environment variable is set, that port will be
  1397.         selected when Pro-YAM initializes.  Otherwise, a port is selected by
  1398.         the startup and/or dialing script.  Typical values are tty01
  1399.         (386/ix) and tty2A (Xenix).
  1400.  
  1401.         EXAMPLE: DPORT=tty1A; export DPORT
  1402.  
  1403.  
  1404.         SEE ALSO: handshake command, dport string parameter
  1405.  
  1406.       portx hbase,irq * To support specialized multiport serial interfaces,
  1407.         the portx command selects a communications port with a specified
  1408.         hexadecimal base address hbase and Interrupt Request Line irq (3 <=
  1409.         irq <= 7).  The portx does not check its argument for validity.  The
  1410.         consequences of an invalid selection are quite undefined.  The
  1411.         specified base address and IRQ number are assigned to COM9, where
  1412.  
  1413.  
  1414.       (C) 1990 Omen Tech Inc                     Chapter 4 Selected Commands
  1415.  
  1416.  
  1417.       DSZ Manual Addendum                                 Line Printer Draft
  1418.       Selected Commands                                                   23
  1419.  
  1420.         they may be used by the port command and the x numeric parameter.
  1421.         The status line and s command will indicate COM9.  This command not
  1422.         available on X.PC, Unix, Xenix, or OS/2.
  1423.  
  1424.         EXAMPLE: portx 3f8,4 Selects a comm port with a base address of 3f8,
  1425.         using IRQ4.
  1426.  
  1427.  
  1428.       rb [-options] Receives with options 1 or more files using YMODEM batch
  1429.         protocol.  The rb command also receives files sent with SEAlink
  1430.         protocol.  Chapter 20 describes the available options.  The pathname
  1431.         and length of each file are transmitted in batch mode.  If a file is
  1432.         received in error (retries exhausted, etc.), the batch transfer will
  1433.         terminate.  If Restricted, a file received in error will be unlinked
  1434.         (erased).
  1435.  
  1436.         EXAMPLE: rb -y Receive file(s) with YMODEM replacing old files, if
  1437.         any.
  1438.  
  1439.  
  1440.         EXAMPLE: rb -g Receive file(s) with YMODEM-g.
  1441.  
  1442.         Many programs claiming to support YMODEM actually use XMODEM with
  1443.         1024 byte blocks; use YAM's sx -k, rx and rx -g XMODEM commands with
  1444.         these mutants.
  1445.  
  1446.         SEE ALSO: YMODEM protocol, Chapter 13.
  1447.  
  1448.       rb [-options] [dir] [file ...] Receives with options 1 or more files
  1449.         using YMODEM batch protocol.  An optional disk and/or directory dir
  1450.         may be specified.  The optional supplied pathnames file ...  are
  1451.         used in place of pathnames normally provided by the sending program.
  1452.         If the sending program attempts to send more files than the number
  1453.         of names supplied to the rb command, the transfer is aborted.
  1454.  
  1455.       rc [-options] file Receives with options a single file using the Ward
  1456.         Christensen XMODEM protocol, 128 or 1024 byte blocks, and CRC-16
  1457.         instead of an 8 bit checksum.  YAM signals the sending program that
  1458.         CRC-16 is to be used.  After four errors while attempting to receive
  1459.         the first sector, YAM will cancel the CRC-16 option and reverts to
  1460.         checksum operation.
  1461.  
  1462.         The probability of an undetected transmission error is much less if
  1463.         CRC-16 is used in place of the default 8 bit arithmetic checksum.
  1464.         Omen Technology Incorporated Recommends use of the 16 bit CRC to
  1465.         maintain data integrity at professional levels.  Chapter 20
  1466.         describes the available options to the rc command.  If Restricted, a
  1467.         file received in error will be deleted.
  1468.  
  1469.         EXAMPLE: rc foo.com
  1470.  
  1471.  
  1472.  
  1473.       (C) 1990 Omen Tech Inc                     Chapter 4 Selected Commands
  1474.  
  1475.  
  1476.       DSZ Manual Addendum                                 Line Printer Draft
  1477.       24                                                   Selected Commands
  1478.  
  1479.         SEE ALSO: XMODEM-CRC protocol, Chapter 13.
  1480.  
  1481.       ro [-options] file Receives with options a single file using non-
  1482.         standard XMODEM-CRC protocol logic.  OverThruster(TM) speeds file
  1483.         downloads at the expense of error recovery.  OverThruster operation
  1484.         is controlled by the O numeric parameter.  As fans of Buckaroo
  1485.         Bonzai know, the OverThruster is not universally applicable.  A
  1486.         transmission error will almost always terminate an OverThruster file
  1487.         download.
  1488.  
  1489.         If Restricted, a file received in error will be unlinked (erased).
  1490.  
  1491.         EXAMPLE: ro foo.com
  1492.  
  1493.  
  1494.         SEE ALSO: O numeric parameter
  1495.  
  1496.       rx [-options] file Receives with options a single file using the Ward
  1497.         Christensen XMODEM protocol.  CRC-16 is not the default because most
  1498.         commercial comms programs only support the 8 bit checksum.  Chapter
  1499.         20 describes the available options.  If Restricted, a file received
  1500.         in error will be unlinked (erased).
  1501.  
  1502.         EXAMPLE: rx foo.com
  1503.  
  1504.         The rc command should be used whenever possible instead of rx.
  1505.  
  1506.         EXAMPLE: rx -g foo.txt Receive a single file with an ACKless XMODEM
  1507.         protocol mutant incorrectly called "ymodem-g" by PCBoard and Qmodem
  1508.         programs.
  1509.  
  1510.         SEE ALSO: XMODEM protocol, Chapter 13.
  1511.  
  1512.       rz [-options] Receives with options 1 or more files using ZMODEM batch
  1513.         protocol.  Chapter 20 describes the available options.  Each file's
  1514.         pathname is obtained from the sending program.  The +, a, b, n, N,
  1515.         r, and y options are accepted from the sending program, subject to
  1516.         Restriced privileges.  If the +, b, n, N, r, or y option is
  1517.         specified to the receiver, it overrides any contrary options
  1518.         specified to the sender.  Only one of the a, b, or r options may be
  1519.         specified.  Only one of the +, n, N, or y options may be specified.
  1520.         If a file is received in error (retries exhausted, etc.), the batch
  1521.         transfer will terminate.  If Restricted, a file received in error
  1522.         will be unlinked (erased).
  1523.  
  1524.         EXAMPLE: rz -y
  1525.  
  1526.  
  1527.         SEE ALSO: Z mode
  1528.  
  1529.         SEE ALSO: ZMODEM protocol, Chapter 13.
  1530.  
  1531.  
  1532.       (C) 1990 Omen Tech Inc                     Chapter 4 Selected Commands
  1533.  
  1534.  
  1535.       DSZ Manual Addendum                                 Line Printer Draft
  1536.       Selected Commands                                                   25
  1537.  
  1538.       rz [-options] [dir] [file ...] Receives with options 1 or more files
  1539.         using ZMODEM batch protocol.  An optional disk and/or directory dir
  1540.         may be specified.  The optional supplied pathnames file ...  are
  1541.         used in place of pathnames normally provided by the sending program.
  1542.         If the sending program attempts to send more files than the number
  1543.         of names supplied to the rz command, the transfer is aborted.  To
  1544.         allow use of the rz command, Z mode (ZMODEM AutoDownload) should be
  1545.         turned off with a dis -Z command.
  1546.  
  1547.       sb [-options] [PREFIX=p | ONAME=x] pathspec Send the files specified
  1548.         in pathspec using True YMODEMTm Protocol.  The pathname, length, and
  1549.         modification time of each file are transmitted.  Files which cannot
  1550.         be opened are skipped.  An empty pathspec sends all files in the
  1551.         current directory.  A directory name expands to all regular files in
  1552.         that directory.
  1553.  
  1554.         If an error aborts a file transmission (retries exhausted, etc.),
  1555.         batch transfers terminate.  The sb command will send files with
  1556.         SEAlink protocol if the receiving program requests SEAlink.
  1557.  
  1558.         EXAMPLE: sb -k *.com Sends *.com using 1024 byte packets.
  1559.  
  1560.         The receiver must be commanded to receive the files with an rb
  1561.         command.  Unix and OS/2 users: sb command cannot be used to send
  1562.         source files that grow after the beginning of transmission.
  1563.  
  1564.         SEE ALSO: YMODEM protocol, Chapter 13, SEAlink protocol, Chapter 13.
  1565.  
  1566.       sx [-options] file Send a single file using the Ward Christensen
  1567.         XMODEM or XMODEM-CRC protocol.  The receiving program may request
  1568.         use of a 16 bit CRC, which is more accurate than the default
  1569.         checksum.  DOS/Unix files sent this way will have Control-Z (CPMEOF)
  1570.         garbage characters appended to make the file length a multiple of
  1571.         128.
  1572.  
  1573.         EXAMPLE: sx foo.com
  1574.  
  1575.  
  1576.         EXAMPLE: sx -k foo.com Sends foo.com using 1024 byte blocks
  1577.  
  1578.         The receiver must be commanded to receive the file with an rx
  1579.         filename or rc filename command.
  1580.  
  1581.         SEE ALSO: XMODEM, XMODEM-1k, XMODEM-CRC protocols, Chapter 13.
  1582.  
  1583.       sz [-options] [PREFIX=p | ONAME=x] pathspec Send the files specified
  1584.         in pathspec using ZMODEM Protocol.[1] If the remote supports ZMODEM
  1585.  
  1586.  
  1587.  
  1588.  
  1589.  
  1590.  
  1591.       (C) 1990 Omen Tech Inc                     Chapter 4 Selected Commands
  1592.  
  1593.  
  1594.       DSZ Manual Addendum                                 Line Printer Draft
  1595.       26                                                   Selected Commands
  1596.  
  1597.         AutoDownload, or accepts rz followed by carriage return as a command
  1598.         to receive files with ZMODEM protocol, only the sz command need be
  1599.         given.  Otherwise, the receiver must be commanded to receive the
  1600.         files with an rz command or menu choice.
  1601.  
  1602.         The +, a, b, n, N, r, y, and Z options are sent to the receiving
  1603.         program.  Only one of the a, b, or r options may be specified.  Only
  1604.         one of the +, n, N, or y options may be specified.
  1605.  
  1606.         Each skipped file is counted as an error as indicated by the e test
  1607.         condition and e numeric parameter.  If the q option is used, files
  1608.         skipped as a result of selective file transfers are not counted as
  1609.         errors.
  1610.  
  1611.         The pathname, length, and modification time of each file are
  1612.         transmitted.  Files which cannot be opened are skipped.  An empty
  1613.         pathspec sends all files in the current directory.  A directory name
  1614.         expands to all regular files in that directory.
  1615.  
  1616.         If ONAME=x is given after the options (if any) and before the file
  1617.         name(s), x will be used exactly as given as the COMPLETE destination
  1618.         pathname instead of each file's actual pathname.  It is the sender's
  1619.         responsibility to use lower case for x unless the filename is really
  1620.         supposed to be all caps.
  1621.  
  1622.         EXAMPLE: sz -y ONAME=B:/spiked/secret /soviet/sdi/newlaser.doc
  1623.         Results in the destination file secret on drive B: in the /spiked
  1624.         directory.  (Destination directories must exist and be writable).
  1625.  
  1626.  
  1627.         If instead PREFIX=p is given after the options (if any) and before
  1628.         the file name(s), p will be added to the destination pathname(s) as
  1629.         a prefix.  It is the sender's responsibility to use lower case for p
  1630.         unless the prefix is really supposed to be all caps.
  1631.  
  1632.         EXAMPLE: sz -y PREFIX=C:/foobaz/ /biff/bam/aardvark.wak
  1633.         Results in the destination file "C:/foobaz/aardvark.wak"
  1634.  
  1635.  
  1636.         EXAMPLE: sz *.com   Sends all files with a .com extension.
  1637.  
  1638.  
  1639.         EXAMPLE: sz -r ??log Crash Recovery sends only the new data if the
  1640.         receiver has incomplete versions of these files.
  1641.  
  1642.  
  1643.       ______________________________________________________________________
  1644.  
  1645.        1. The receiver may use the sz command to send files by uploading an
  1646.           sz command with the zcommand command.
  1647.  
  1648.  
  1649.  
  1650.       (C) 1990 Omen Tech Inc                     Chapter 4 Selected Commands
  1651.  
  1652.  
  1653.       DSZ Manual Addendum                                 Line Printer Draft
  1654.       Selected Commands                                                   27
  1655.  
  1656.         EXAMPLE: sz -fn src/*.c src/*.h maildir
  1657.         Sends only newer .c and .h files in the src subdirectory, and all
  1658.         new files in the maildir subdirectory.
  1659.  
  1660.  
  1661.         EXAMPLE: zcommand "sz -fn /bin /wp"
  1662.         commands a remote YAM system in Host Operation (unrestricted) to
  1663.         send all new files in the /bin and /wp directories.
  1664.  
  1665.  
  1666.         EXAMPLE: sz -Yn *.c Sends only newer versions of files that already
  1667.         exist at the destination.
  1668.  
  1669.  
  1670.         EXAMPLE: sz -Rf usera Sends all files in the usera directory and all
  1671.         subdirectories thereof.  Directories are not sorted when the R
  1672.         option is used on 16 bit systems.
  1673.  
  1674.         SEE ALSO: ZMODEM protocol, Chapter 13, Options, Chapter 20.
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.       (C) 1990 Omen Tech Inc        Chapter 4 Protocol File Transfer OPTIONS
  1710.  
  1711.  
  1712.       DSZ Manual Addendum                                 Line Printer Draft
  1713.       28                                      Protocol File Transfer OPTIONS
  1714.  
  1715.       5.  OPTIONS for Protocol File Transfers
  1716.  
  1717.       Options modify the way the protocol file transfer commands send and
  1718.       receive files.  They are reset before each command line.
  1719.  
  1720.       The a and b options are mutually exclusive.  With ZMODEM, a b option
  1721.       given to the sender or receiver will override any a option.
  1722.  
  1723.       The +, c, r, N, n, p, and y options are mutually exclusive.  The Y
  1724.       option may be followed by the c, +, r, n, or N option.  Specifying
  1725.       these options to the receiver overrides the ZMODEM sender's
  1726.       specification of these options.
  1727.  
  1728.  
  1729.       +  When receiving to a file already on disk, append the new data to
  1730.          the old file (if one exists).  This option is not allowed if YAM is
  1731.          Restricted.
  1732.  
  1733.          When sending files with ZMODEM, the + option commands the receiver
  1734.          to append to a file already on the receiver's disk.
  1735.  
  1736.          EXAMPLE: sz -+ ONAME=master.log *.log sends all .log files in the
  1737.          current directory to be appended to master.log on the receiver's
  1738.          computer.
  1739.  
  1740.          NOTE: Append (+) is not the same as crash recovery (-r).  Append is
  1741.          used to concatenate (add) new data to an existing file.  The
  1742.          resulting file contains both old and new data.
  1743.          NOTE: If an append (+) file transfer is interrupted and restarted,
  1744.          data may be duplicated.
  1745.  
  1746.          SEE ALSO: r option
  1747.  
  1748.       7  Strip data to 7 bits for file transfers with the Kermit protocol.
  1749.          Program executables and other 8 bit binary files cannot be sent
  1750.          this way.  In the absence of the 7 option YAM transfers all 8 bits
  1751.          of each byte.  If the communications line is set to 8 bits no
  1752.          parity, the 8th bit is transmitted, otherwise YAM requests 8th bit
  1753.          quoting.  NOTE: The 7 option is distinct from the 7e and 7o modes.
  1754.  
  1755.       a  (ASCII) The a option applies to files received with XMODEM, YMODEM,
  1756.          or ZMODEM protocol.  It converts newlines not preceded by CR to
  1757.          CR/LF pairs.  NULL, RUBOUT, and all characters in each packet
  1758.          beginning with Ctrl-Z are excluded.  The a option is useful when
  1759.          receiving text files without carriage returns directly from Unix
  1760.          systems.
  1761.  
  1762.          When sending with ZMODEM, the a option instructs the receiver to
  1763.          convert text files to the conventions used in its operating
  1764.          environment.  When sending to VAX/VMS RZ this selects CR carriage
  1765.          control variable length record format.
  1766.  
  1767.  
  1768.       (C) 1990 Omen Tech Inc        Chapter 5 Protocol File Transfer OPTIONS
  1769.  
  1770.  
  1771.       DSZ Manual Addendum                                 Line Printer Draft
  1772.       Protocol File Transfer OPTIONS                                      29
  1773.  
  1774.          The a option does not apply to the Kermit, sx, or sb commands.
  1775.          Files transferred with the a option cannot be processed with the
  1776.          ZMODEM r (recover/resume) option.
  1777.  
  1778.          EXAMPLE: rc -a program.c receives program.c and converts end of
  1779.          lines to CR/LF.
  1780.  
  1781.  
  1782.       b  (Binary) With ZMODEM, inhibits the receiver from translating the
  1783.          file contents.  If either the ZMODEM sender or receiver specifies b
  1784.          option, any contrary requests will be ignored.
  1785.  
  1786.          EXAMPLE: sz -b program.exe
  1787.  
  1788.  
  1789.       c  With ZMODEM, change the file name to prevent collision if the
  1790.          destination file exists.  The receiving program must support the
  1791.          ZMODEM c option or file disposition will be undefined.  The form of
  1792.          the invented (changed) file name is implementation dependent.
  1793.  
  1794.          Use CRC-16 with the rx, rt, and r7 commands.
  1795.  
  1796.       e  Normally, ZMODEM senders escape XON, XOFF, Ctrl-P, CR-@-CR, and
  1797.          Ctrl-X, and ZMODEM receivers ignore XON and XOFF.  The e option
  1798.          escape all control characters when sending files with the ZMODEM
  1799.          protocol.  In 7-bit environments, the e option also escapes RUBOUT
  1800.          (7F).[1] This option is useful when operating with brain damaged
  1801.          data PBX systems and other types of "front ends".
  1802.  
  1803.          SEE ALSO: zmtxesc, zmrxesc string parameters
  1804.  
  1805.       E  With ZMODEM-90, force 8th bit encoding even if the transmission
  1806.          medium appears to support 8 bits.[2]
  1807.  
  1808.       f  Send the full pathname as specified (exclusive of disk identifier)
  1809.          when using a batch send command.  Normally only the file name
  1810.          portion (without any directory prefix) is transmitted.  The f
  1811.          option applies to batch file transmission with the kermit sb, sb,
  1812.          send, and sz commands.
  1813.  
  1814.          EXAMPLE: cd /src; sz -f robot/r2d2.h sends the file with the
  1815.          pathname robot/r2d2.h.
  1816.  
  1817.  
  1818.  
  1819.       __________
  1820.  
  1821.        1. In 7-bit environments, ZMODEM always escapes FF.
  1822.  
  1823.        2. Not featured in DSZ.COM.
  1824.  
  1825.  
  1826.  
  1827.       (C) 1990 Omen Tech Inc        Chapter 5 Protocol File Transfer OPTIONS
  1828.  
  1829.  
  1830.       DSZ Manual Addendum                                 Line Printer Draft
  1831.       30                                      Protocol File Transfer OPTIONS
  1832.  
  1833.          EXAMPLE: sz -f /src/robot/vox/3tpi0.*
  1834.  
  1835.  
  1836.          SEE ALSO: PREFIX=p flag for the sb and sz commands.
  1837.  
  1838.       F  Insert a pause after each transmitted data subpacket transmitted
  1839.          with ZMODEM.  This is useful in certain situations when
  1840.          conventional flow control methods are unavailable, ineffective, or
  1841.          unreasonably slow (i.e., "broken").  The length of pause is set by
  1842.          the zmodem F numeric parameter.
  1843.  
  1844.          EXAMPLE: sz -F honker.dat
  1845.  
  1846.  
  1847.          SEE ALSO: zmodem F numeric parameter
  1848.  
  1849.       g  Given to the receiving program, the g option to the rb command
  1850.          allows the sender and receiver to dispense with acknowledging each
  1851.          transmitted packet when using YMODEM batch transfers.  YMODEM-g
  1852.          increases throughput when the transmitting medium itself (direct
  1853.          connection, X.PC session, or error correcting modems) provides
  1854.          error free transmission.  The transmitting medium can use XOFF and
  1855.          XON to enforce flow control.
  1856.  
  1857.          If the transmitting medium does not enforce flow control,[3] the
  1858.          user must insure the receiver is not overrun.  YAM on a PC or XT
  1859.          accepts data at 9600 bps without flow control when the file is
  1860.          being written to a hard disk or ramdisk.[4]
  1861.  
  1862.          If an error is detected when the g option is used, the transfer is
  1863.          aborted.
  1864.  
  1865.          EXAMPLE: rb -g
  1866.  
  1867.  
  1868.          The g option may also be used with the rx command to receive files
  1869.          from Qmodem's G protocol.
  1870.  
  1871.       i  With YMODEM or ZMODEM, instructs the receiver to write file(s) in
  1872.          stream oriented Image format.  When sending to the VAX/VMS version
  1873.          of rz, the i option selects Stream_LF record format.  Stream_LF
  1874.          preserves the exact contents of binary files read by VMS C
  1875.  
  1876.  
  1877.       __________
  1878.  
  1879.        3. X.PC automatically enforces end to end flow control.
  1880.  
  1881.        4. Provided no memory resident programs or special drivers hog CPU
  1882.           cycles.
  1883.  
  1884.  
  1885.  
  1886.       (C) 1990 Omen Tech Inc        Chapter 5 Protocol File Transfer OPTIONS
  1887.  
  1888.  
  1889.       DSZ Manual Addendum                                 Line Printer Draft
  1890.       Protocol File Transfer OPTIONS                                      31
  1891.  
  1892.          programs.  Stream_LF is useful for file servers and archives that
  1893.          service PCs, as well as C programs on VMS itself.  (Without the i
  1894.          option, the VMS rz default is 512 byte fixed length record format.)
  1895.  
  1896.       I  With YMODEM or ZMODEM, instructs the receiver to write file(s) in
  1897.          variable length binary record Image format.  When sending to the
  1898.          VAX/VMS version of rz, the i option selects Variable length
  1899.          (mrs=510) binary record format.  Certain programs such as Kermit32
  1900.          understand this binary record format better than Stream_LF.
  1901.  
  1902.       k  Use 1024 byte (1K) packets with the sb and sx commands.  The
  1903.          default packet length is 128.  This increases throughput when the
  1904.          speed is high relative to the response times of the communications
  1905.          channel and the computers.  The k option is useful with 9600 or
  1906.          19200 bps transfers with directly connected timesharing systems.
  1907.          The k option may not work properly uploading to some systems,
  1908.          particularly heavily loaded or poorly implemented timesharing
  1909.          systems at high speeds.  The k option is valid only when sending to
  1910.          YAM, Unix rb, or other compatible programs.  If the file length is
  1911.          not a multiple of 1024, the remainder of the file will be sent with
  1912.          128 byte blocks.  This option does not affect Kermit transfers.
  1913.  
  1914.          EXAMPLE: sb -k *.c *.h
  1915.  
  1916.          With the sz command, the k option forces an initial 1024 byte
  1917.          subpacket length.
  1918.  
  1919.          EXAMPLE: sz -k *.c *.h
  1920.  
  1921.  
  1922.       l  Force incoming pathnames that are all uppercase to lower case.
  1923.          This is reset by the call command.  This option is ignored on DOS
  1924.          and OS/2.
  1925.  
  1926.       m  (ZMODEM-90) Activate MobyTurbo(TM) for maximum throughput on
  1927.          compressed files sent over completely transparent connections.
  1928.          MobyTurbo can be used over links that support YMODEM-g.  Moby Turbo
  1929.          can not be used with most forms of software flow control or over
  1930.          networks that reserve control characters.
  1931.  
  1932.       M  Locks out Moby Turbo even if the other program has given the m
  1933.          option.  This option is useful if the transmission path does not
  1934.          support complete transparency.
  1935.  
  1936.       n  (ZMODEM) Each file is transferred if the corresponding destination
  1937.          file does not exist, or if the source file is newer.  The n option
  1938.          can be given with either the sz or rz commands.  This option is not
  1939.          allowed if the receiver is Restricted.
  1940.  
  1941.          EXAMPLE: sz -n *.* attempts to send all files in the current
  1942.          directory.  Only those files that do not exist in the destination
  1943.  
  1944.  
  1945.       (C) 1990 Omen Tech Inc        Chapter 5 Protocol File Transfer OPTIONS
  1946.  
  1947.  
  1948.       DSZ Manual Addendum                                 Line Printer Draft
  1949.       32                                      Protocol File Transfer OPTIONS
  1950.  
  1951.          directory, and those for which the source is newer will be sent.
  1952.  
  1953.  
  1954.       N  (ZMODEM) Transfer the file if the corresponding destination file
  1955.          does not exist, or if the source file is newer or longer.  The N
  1956.          option be used with the sz and rz commands.  This option is not
  1957.          allowed if the receiver is Restricted.
  1958.  
  1959.          EXAMPLE: sz -N *.*
  1960.  
  1961.  
  1962.       p  (ZMODEM) Protect destination file; bypass this file if it already
  1963.          exists on the destination system.
  1964.  
  1965.       P  (ZMODEM-90) When transferring files over 7 bit paths, pack 4 8-bit
  1966.          bytes into 5 7-bit bytes for transmission instead of quoting the
  1967.          8th bit.[5] This increases transmission speed on compressed files.
  1968.  
  1969.       q  (Quiet) suppresses block by block status line update during Kermit
  1970.          and X/YMODEM file transfers.  Also prevents skipped files from
  1971.          incrementing the e numeric parameter and e test condition.
  1972.  
  1973.       r  (ZMODEM) Resume/Recover an interrupted file transfer with the
  1974.          ZMODEM protocol.  May be given with either the sz or rz commands.
  1975.  
  1976.          The r option may be used to resume the transmission of a long file
  1977.          after a disconnect or power loss, without having to start over at
  1978.          the beginning of the file.  The r option may also be used when the
  1979.          source file grows from time to time and only the incremental
  1980.          portion needs to be sent.  The r option assumes that the contents
  1981.          of the destination file are identical to the corresponding
  1982.          beginning portion of the source file.  The r option should not be
  1983.          applied to a file that has been modified by the a option.  This
  1984.          option is not allowed if the receiver is Restricted.
  1985.  
  1986.          EXAMPLE: sz -r hugefile.lst
  1987.  
  1988.  
  1989.          SEE ALSO: zmodem c numeric parameter
  1990.  
  1991.          For convenience, the r option can be specified on all files if
  1992.          desired, even those that have not been interrupted during a
  1993.          transfer.  However, if you do make the r option the default with
  1994.          adlopts you could inadvertently overwrite valuable data with
  1995.          unrelated data from a random file with the same file name.
  1996.  
  1997.  
  1998.       __________
  1999.  
  2000.        5. Not supported in DSZ.COM.
  2001.  
  2002.  
  2003.  
  2004.       (C) 1990 Omen Tech Inc        Chapter 5 Protocol File Transfer OPTIONS
  2005.  
  2006.  
  2007.       DSZ Manual Addendum                                 Line Printer Draft
  2008.       Protocol File Transfer OPTIONS                                      33
  2009.  
  2010.          The "ZMODEM Crash Recovery at NNNN" message may not appear when
  2011.          performing Crash Recovery on very short files.
  2012.  
  2013.       rr As above, but the files are compared by taking a 32 bit CRC on the
  2014.          contents before deciding on whether to start a fresh transfer.
  2015.  
  2016.          EXAMPLE: sz -rr maybenewer.lst
  2017.  
  2018.  
  2019.          With the -rr option, all of the files are compared or transmitted
  2020.          by default.  The number of bytes used in the comparison may be
  2021.          restricted by setting the zmodem R numeric parameter to a number
  2022.          between 2048 and 32000 (1 billion on 32 bit flavors).
  2023.  
  2024.          EXAMPLE: zmodem pR20000
  2025.  
  2026.  
  2027.       R  (32 bit Unix systems) Recursively descend directories specified in
  2028.          wild cards when expanding file names.
  2029.  
  2030.          EXAMPLE: sz -Rf src
  2031.          Sends the files in the src directory and its subdirectories (R
  2032.          option), and transmits the full relative pathname (f option).
  2033.  
  2034.  
  2035.          SEE ALSO: f option
  2036.  
  2037.       s  SlugBait modifies the logic of ZMODEM sending to detect and report
  2038.          attempts at evading accountability for receiving files.  Such
  2039.          attempts are flagged with a Q status in the log of sent files.
  2040.          SlugBait adds a slight delay to file transmission, and a transfer
  2041.          that is cut off at the very end of file may very infrequently be
  2042.          reported with Questionable instead of ERROR status.
  2043.  
  2044.       S  When sending file(s) with ZMODEM, interrogate the receiving program
  2045.          for its serial number.  S option terminates when a serial number is
  2046.          received or when the call command is given.  Receiving file(s) with
  2047.          YMODEM or ZMODEM from programs providing a serial number also
  2048.          provides the other program's serial number.  The serial number
  2049.          received is listed by the performance log.
  2050.  
  2051.       t  Enter the term function after file transfer(s) complete.  The t
  2052.          option should not be used in commands given from within the term
  2053.          function, either directly or with soft key definitions.
  2054.  
  2055.       v  View the data being transmitted or received.  Only correct data is
  2056.          displayed.  Viewing standard ASCII files does not interfere with
  2057.          correct transmission at high speeds, although throughput may be
  2058.          degraded.
  2059.  
  2060.          The output may be redirected to a capture file or DOS device with
  2061.  
  2062.  
  2063.       (C) 1990 Omen Tech Inc        Chapter 5 Protocol File Transfer OPTIONS
  2064.  
  2065.  
  2066.       DSZ Manual Addendum                                 Line Printer Draft
  2067.       34                                      Protocol File Transfer OPTIONS
  2068.  
  2069.          the > or >> command.  Unless output is redirected, this option must
  2070.          not be used when YAM is in Host Operation.
  2071.  
  2072.          When invoking Unix Pro-YAM as xyam, rz, sz, rb, sb, rx, or sx,
  2073.          creates a logging file with information useful for debugging
  2074.          purposes.  More v's create more detailed debugging information.
  2075.  
  2076.          SEE ALSO: v numeric parameter, LOGFILE environment variable
  2077.  
  2078.       wN Use a window size of N bytes with the sz command, overriding the
  2079.          zmodem w numeric parameter.  If N is missing, use a ZMODEM window
  2080.          size of 4096 bytes.
  2081.  
  2082.          SEE ALSO: Flow Control Chapter 14, zmodem w numeric parameter
  2083.  
  2084.       WN Request the sending program to use a window size of N bytes,
  2085.          overriding the sender's window size setting, 4096 bytes if N is
  2086.          missing.[6]
  2087.  
  2088.       y  Yes it is OK to replace a file already on disk when receiving a
  2089.          file.  If absent, the operator is given a choice of appending to
  2090.          the current file (a), erasing it (y) or aborting (n).  This option
  2091.          is not allowed if YAM is Restricted.  When sending with ZMODEM,
  2092.          commands the receiver to replace a file on its disk.
  2093.  
  2094.       Y  (ZMODEM) Transfer only those files for which a file with the same
  2095.          pathname exists at the destination, overwriting the destination
  2096.          files.  The Y option may be followed by other ZMODEM options to
  2097.          further qualify the selection of files to transfer.  This option is
  2098.          not allowed if YAM is Restricted.
  2099.  
  2100.          EXAMPLE: sz -Yn *.* If the source directory contains files A, B,
  2101.          and C, each dated today, and the destination directory contains B
  2102.          and C, with B a week old and C dated today, only B will be sent.
  2103.  
  2104.  
  2105.       zT Use T minutes behind GMT (Greenwich Mean Time) as the local
  2106.          timezone instead of the z parameter value for the file(s)
  2107.          transferred with this command.
  2108.  
  2109.          EXAMPLE: sb -k -z300 ESTfile sends ESTfile corrected for creation
  2110.          in Eastern Standard Time.
  2111.  
  2112.  
  2113.  
  2114.  
  2115.       __________
  2116.  
  2117.        6. The W option is supported when receiving files from ZMODEM-90(TM)
  2118.           program versions after Jan 21 1990.
  2119.  
  2120.  
  2121.  
  2122.       (C) 1990 Omen Tech Inc        Chapter 5 Protocol File Transfer OPTIONS
  2123.  
  2124.  
  2125.       DSZ Manual Addendum                                 Line Printer Draft
  2126.       Protocol File Transfer OPTIONS                                      35
  2127.  
  2128.       Z  Transmit files with compression.  The ZMODEM receiver must indicate
  2129.          its ability to decompress received files for this option to take
  2130.          effect.
  2131.  
  2132.          When sending between Unix systems, files are compressed with 12 bit
  2133.          Lempel-Ziv compression.  Otherwise, packets are transmitted with
  2134.          Run Length Encoding.
  2135.  
  2136.          Over slow channels, compression increases the transmission speed of
  2137.          compiler listings, screen dumps, etc. by up to 50 per cent.  LZW
  2138.          compression is more effective on more types of data than RLE
  2139.          compression.  Some files, including the Personal Computing Magazine
  2140.          ASCII Test File, speed up by more than an order of magnitude with
  2141.          either RLE or LZW compression.  Heavily encrypted data and
  2142.          compressed files, including ARC and ZOO archives, do not benefit
  2143.          from ZMODEM compression.
  2144.  
  2145.          The situation with fast compressed modems is more complex.  The
  2146.          benefits of ZMODEM compression will depend on the particular
  2147.          application; try the transfers with and without ZMODEM compression
  2148.          to determine the most efficient options.
  2149.  
  2150.  
  2151.  
  2152.  
  2153.  
  2154.  
  2155.  
  2156.  
  2157.  
  2158.  
  2159.  
  2160.  
  2161.  
  2162.  
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.  
  2177.  
  2178.  
  2179.  
  2180.  
  2181.       (C) 1990 Omen Tech Inc                    Chapter 5 Numeric Parameters
  2182.  
  2183.  
  2184.       DSZ Manual Addendum                                 Line Printer Draft
  2185.       36                                                  Numeric Parameters
  2186.  
  2187.       6.  NUMERIC PARAMETERS
  2188.  
  2189.       O    Controls OverThruster(TM) operation with the ro command (XMODEM,
  2190.            XMODEM-1k, and YMODEM) downloads.  This parameter should be set
  2191.            as follows:
  2192.  
  2193.            CompuServe XMODEM Negative numbers control the number of bytes
  2194.            added to the window on XMODEM downloads from the CompuServe
  2195.            Information Service.  Larger numbers increase throughput, but
  2196.            cause improperly interfaced MNP modems on CIS nodes to drop
  2197.            characters under stress, disrupting the file transfer.
  2198.  
  2199.            EXAMPLE: dsz pO-512 ro file1.ext
  2200.  
  2201.            Other XMODEM Positive numbers up to a system dependent value less
  2202.            than the protocol block size increase throughput.  Larger values
  2203.            induce timeouts and/or retransmitted blocks.  The optimum value
  2204.            must be determined by experiment.  30 to 60 gives best results
  2205.            with MNP modems at 2400 bps.  The optimum value varies depending
  2206.            on the remote computer, modem(s), system traffic, and the network
  2207.            node.  Performance improvement with high O parameter values is
  2208.            greater with sluggish networks.
  2209.  
  2210.            EXAMPLE: dsz pO60 ro file1.ext
  2211.  
  2212.            EXAMPLE: dsz pO1000 rb -o              (EXEC-BBS, MNP 5, 9600
  2213.            bps)
  2214.  
  2215.       6.1  X/Y/ZMODEM Numeric Parameters
  2216.  
  2217.       These parameters control XMODEM, YMODEM, and ZMODEM protocol
  2218.       transfers.  They are set with the z px# command available with ZMODEM
  2219.       flavors of YAM.
  2220.  
  2221.       EXAMPLE: z pl16384
  2222.       Forces ZMODEM packet length of 16384 (default packet length is
  2223.       infinite).
  2224.  
  2225.       Their current values can be displayed with a z p command.  These
  2226.       parameters rarely need changing in normal environments.
  2227.  
  2228.       b If non zero, ZMODEM sends a break when it is sending a file and
  2229.         receives a retransmission request.  This mode of operation may be
  2230.         used with high speed modems to clear unwanted characters from the
  2231.         modem's buffer during error recovery.  Usually, the modem must be
  2232.         given a configuration command to set the proper action to take when
  2233.         receiving a break signal.
  2234.  
  2235.       B Sets the duration of the break signal in tenths of a second, default
  2236.         2 (200 milliseconds).
  2237.  
  2238.  
  2239.  
  2240.       (C) 1990 Omen Tech Inc                    Chapter 6 Numeric Parameters
  2241.  
  2242.  
  2243.       DSZ Manual Addendum                                 Line Printer Draft
  2244.       Numeric Parameters                                                  37
  2245.  
  2246.       c Enables Cybernetic Data Recovery(TM) on XMODEM and YMODEM transfers.
  2247.         Setting this parameter to 0 accommodates programs with non standard
  2248.         XMODEM/YMODEM protocols and slightly quickens file transfers.  The
  2249.         default value of 1 provides optimum reliability for XMODEM and
  2250.         YMODEM transfers with programs that meet the XMODEM/YMODEM spec.
  2251.  
  2252.         Setting this parameter to -1 disables the quick file compare
  2253.         provided by the r option.
  2254.  
  2255.       C Sets the number of times ZMODEM will attempt to send a command (as a
  2256.         result of a zcommand command) (default 11).
  2257.  
  2258.       e If non zero, escape all control characters.  This allows ZMODEM
  2259.         transfers to operate over data PBX and other systems that freak out
  2260.         when they receive control characters.
  2261.  
  2262.       d Some operating systems, most notably VAX/VMS, use ^X to stop
  2263.         programs.  ZMODEM uploads consist of a "rz" command to start the rz
  2264.         program followed by a ZMODEM packet.  If the ^X in the ZMODEM packet
  2265.         causes problems, the zmodem d parameter can be used to delay the
  2266.         initial ZMODEM packet until the rz program initializes itself.  The
  2267.         zmodem d parameter sets a delay in tenths of a second on ZMODEM
  2268.         sends (uploads) between the "rz" command and the first packet.
  2269.  
  2270.       f Flow control mask, only used with Unix/Xenix systems.  Setting this
  2271.         to 0 (the default) disables hardware (RTS/CTS) flow control for
  2272.         Xenix/Unix systems with broken hardware flow control.  On Xenix/Unix
  2273.         systems where only CTS flow control works properly, set this to 8192
  2274.         to allow CTS flow control only.  If both RTS and CTS flow control
  2275.         work properly (rare!) you can use a value of -1 to enable both bits.
  2276.  
  2277.       F Sets the pause after each data subpacket sent with the sz command
  2278.         when the F option is used, or when failing flow control is detected.
  2279.         The default value of 1 causes a one tenth second delay.
  2280.  
  2281.         SEE ALSO: F option On some Unix operating systems the pause will be
  2282.         rounded up to the next second or two.
  2283.  
  2284.       l Normally, the ZMODEM "packet length" ("block length") is the file
  2285.         length.  Setting this parameter non zero forces ZMODEM to close a
  2286.         frame and wait for an ACK after each # bytes (default 0).  This
  2287.         makes ZMODEM behave like XMODEM, YMODEM, or JMODEM, which wait after
  2288.         each block/packet for an acknowledgement before going on to the next
  2289.         block.  The packet length may be adjusted to prevent buffer overflow
  2290.         in data PBX systems.  The call command resets this parameter to 0.
  2291.  
  2292.       L (Default 0) If non zero, overrides the nominal length of data
  2293.         subpackets within each ZMODEM frame.  A smaller value speeds error
  2294.         recovery on noisy lines, a large value (maximum 1024) reduces the
  2295.         overhead of CRC characters.  The call command resets this parameter
  2296.         to 0.
  2297.  
  2298.  
  2299.       (C) 1990 Omen Tech Inc                    Chapter 6 Numeric Parameters
  2300.  
  2301.  
  2302.       DSZ Manual Addendum                                 Line Printer Draft
  2303.       38                                                  Numeric Parameters
  2304.  
  2305.         Please note that streaming ZMODEM has no direct equivalent to
  2306.         XMODEM/YMODEM/JMODEM block length unless the zmodem l parameter is
  2307.         set non zero.  In the absence of errors, ZMODEM normally sends the
  2308.         entire file without pause.  If somebody claims ZMODEM's 1024 byte
  2309.         subpacket length is slowing things down by more than one half per
  2310.         cent, he doesn't understand ZMODEM and should be ignored.
  2311.  
  2312.       n Sets the number of NULLS (default 0) sent before each ZDATA frame.
  2313.         Some buffered modems (Fastcomm) have a firmware bug which loses
  2314.         characters when changing the direction of transmission.  This causes
  2315.         data frames to fail with a CRC or other error.  ZMODEM n parameter
  2316.         values in the range of 100 to 150 have obviated this syndrome.
  2317.  
  2318.       P When set to 2 (the default), purge the transmit buffer and force a
  2319.         receiver response when a CR/LF sequence (indicating a PC-Pursuit
  2320.         DATA LOSS message) is detected.  A value of 1 does not purge the
  2321.         transmit buffer.  A value of 0 disables special processing of CR/LF
  2322.         sequences received by the sending ZMODEM.
  2323.  
  2324.       w If non 0, restrict the ZMODEM transmit window to the specified
  2325.         number of bytes.  Setting this parameter to N requests
  2326.         acknowledgements from the receiver every N/4 characters.  Pro-YAM
  2327.         then waits for acknowledgements from the receiver whenever it has
  2328.         sent N more characters than it has received acknowledgements for.
  2329.         This parameter is useful with networks with defective flow control,
  2330.         and with networks that store an excessive number of characters in
  2331.         transit.  The call command resets this parameter to 0.
  2332.  
  2333.       W Adjusts the number of characters the ZMODEM receiver will silently
  2334.         ignore when searching for the beginning of a new frame.  This may be
  2335.         set larger to accomodate networks with excessive in transit storage,
  2336.         smaller to speed error recovery from long error bursts on direct
  2337.         connections.  The call command resets this parameter to the default
  2338.         (1400).
  2339.  
  2340.       Z Number of minutes (default 0) to adjust the file modification date
  2341.         when using the Telink or Clink/SEAlink file transfer protocol to
  2342.         transfer a file between different time zones.
  2343.  
  2344.       The timeout parameters below may be set lower for faster X/YMODEM
  2345.       error recovery when transferring files between two micros, higher to
  2346.       accomodate extremely sluggish systems.  Only in pathological cases is
  2347.       it necessary to modify these parameters.  The call command resets
  2348.       these parameter to their defaults.
  2349.  
  2350.       p Timeout in tenths of seconds for gaps within a packet (default 100).
  2351.  
  2352.       r If non zero, remove incomplete files received with a protocol except
  2353.         those received with the + option (default 0).
  2354.  
  2355.  
  2356.  
  2357.  
  2358.       (C) 1990 Omen Tech Inc                    Chapter 6 Numeric Parameters
  2359.  
  2360.  
  2361.       DSZ Manual Addendum                                 Line Printer Draft
  2362.       Numeric Parameters                                                  39
  2363.  
  2364.       R When non 0, limits the number of bytes of file comparision used with
  2365.         the sz and rz -rr option.  This parameter may be set to a value
  2366.         between 2048 and 32000 (1 billion on 32 bit systems).  This
  2367.         parameter is given to the receiving program.
  2368.  
  2369.         EXAMPLE: z pR30000
  2370.  
  2371.  
  2372.         SEE ALSO: -rr option
  2373.  
  2374.       s Timeout interval in seconds waiting for XON characters or positive
  2375.         flow control (default 15).  If an XON is not received within this
  2376.         time, transmission resumes anyway.  A value of 0 disables this
  2377.         timeout.
  2378.  
  2379.       t XMODEM, YMODEM, and ZMODEM Receiver timeout in tenths of seconds
  2380.         waiting for a packet or command acknowledgement (default 100).
  2381.  
  2382.       T Transmitter timeout in tenths of seconds waiting for a packet
  2383.         (default 600).
  2384.                                                   /
  2385.                                                ==|--
  2386.                                                == \
  2387.                                                ==
  2388.                                                ==
  2389.                                              [][][]
  2390.  
  2391.                       "I don't know what this thing does,
  2392.                       but it's pointing in your direction."
  2393.                       -Dr. Who, from A Usenet Signature
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.  
  2414.  
  2415.  
  2416.  
  2417.       (C) 1990 Omen Tech Inc                Chapter 6 Hardware Compatability
  2418.  
  2419.  
  2420.       DSZ Manual Addendum                                 Line Printer Draft
  2421.       40                                              Hardware Compatability
  2422.  
  2423.       7.  HARDWARE/SOFTWARE COMPATABILITY
  2424.  
  2425.       7.1  Hardware Compatibility Notes
  2426.  
  2427.       IBM PS/2 Model 50Z Early samples of this machine have a design error
  2428.         on the motherboard that causes comms programs to lock up the
  2429.         machine.  Replacing the motherboard with a correctly functioning
  2430.         unit from current production corrects the problem.  The part number
  2431.         of the replacement PS2/50 Z motherboard is 35F5928.  (Information
  2432.         provided by John M. Choma 73047,3566) In the U.S. IBM has
  2433.         stonewalled on this issue, but in December 1988 agreed to replace
  2434.         the defective motherboards under warranty.
  2435.  
  2436.  
  2437.       NEC Multispeed The NEC Multispeed computer locks up unless STACKS is
  2438.         set in CONFIG.SYS.  In addition, one should disable floppy disk
  2439.         power save mode, and set popup program memory allocation to 0.  For
  2440.         best results, use the latest NEC software patches to the NEC MSDOS,
  2441.         and/or use an IBM PC-DOS instead of the DOS supplied by NEC.
  2442.  
  2443.       EGA/VGA Multimode Boards Some multimode EGA and VGA boards include an
  2444.         "auto select" feature designed to configure the board to various
  2445.         display standards using software trickery.  In the case of Paradise
  2446.         VGA and others, this feature causes excessive interrupt latency and
  2447.         loss of data at high speeds.  Disabling the auto select on the
  2448.         display board corrects this problem.
  2449.  
  2450.       EGA Wonder The BIOS in the ATI EGA Wonder has been observed to
  2451.         increase interrupt latency to the dismay of 9600 bps operation on an
  2452.         8 mHz no wait state AT clone.  There has also been a report
  2453.         (unexplained) that an EGA board has induced line noise in one
  2454.         instance.
  2455.  
  2456.       Tecmar Graphics Master To use YAM with this display board, give a mode
  2457.         mono command before running Pro-YAM.
  2458.  
  2459.       Leading Edge MODEMS and I/O BOARDS Some Leading Edge modems and
  2460.         interface boards use 8250 UART devices that do not respond correctly
  2461.         when the software turns the transmitter interrupts on and off.  High
  2462.         performance communications programs such as Professional-YAM require
  2463.         properly functioning UART chips, such as the National Semiconductor
  2464.         16450 or 16550A.
  2465.  
  2466.  
  2467.       7.2  Brain Damaged UARTS
  2468.  
  2469.       Omen Technology has received reports of problems with buggy 8250 type
  2470.       UART integrated circuits in Leading Edge modem boards, serial port
  2471.       interfaces, and computers.  The defective chip logic affects high
  2472.       performance software.  Replacing the buggy chip with a newer chip
  2473.       (NS16550AN) corrects the problem.
  2474.  
  2475.  
  2476.       (C) 1990 Omen Tech Inc                Chapter 7 Hardware Compatability
  2477.  
  2478.  
  2479.       DSZ Manual Addendum                                 Line Printer Draft
  2480.       Hardware Compatability                                              41
  2481.  
  2482.       The UM82450 chip in the Zoom 2400HC also appears to cause problems.
  2483.       Zoom Telephonics advises that this problem is limited to their old
  2484.       model.  The old model is inentifiable by an external volume control.
  2485.  
  2486.       You can identify an old chip by inspecting the serial interface board
  2487.       for 8250 or UM82450 type devices.  A service technician or hardware
  2488.       hacker can help if you are not familiar with reading chip numbers.
  2489.  
  2490.       Dsz users can identify old chips with the following software command:
  2491.  
  2492.       EXAMPLE: dsz port 1 speed 2400 p
  2493.  
  2494.       ZCOMM and Professional-YAM users can look at the printout produced by
  2495.       the s command;  old UART chips register as TYP 0.
  2496.  
  2497.       The National Semiconductor NS16550AN is a pin compatible plug in
  2498.       replacement for 8250 and 16450 serial chips.  Omen Technology software
  2499.       enables the FIFO buffer in the NS16550AN to prevents loss of data from
  2500.       poorly written device drivers, TSR programs, etc.
  2501.  
  2502.       We are also using the Goldstar GM82C550 chip with a 9025 date code.
  2503.       This Goldstar chip is plug compatible with the National chips.  No
  2504.       problems have been discovered with this chip.
  2505.  
  2506.       The NS16550AN has better electrical characteristics than the older
  2507.       UART chips.  386 and fast 286 machines should use the NS16550AN for
  2508.       best results.  Omen Technology software has been written to allow time
  2509.       for the older UART chips to operate. However, there is a limit to how
  2510.       much the software can rearrange chip accesses without resorting to
  2511.       performance robbing wait loops.  Some other software is not as
  2512.       forgiving of slow chips.
  2513.  
  2514.       Be sure to ask for the NS16550AN.  It is VITAL to get the National
  2515.       Semiconductor "AFN" or "AN" chip.  Other vendors' chips not mentioned
  2516.       above won't do.  Current Western Digital WD16C550 chips do not
  2517.       function properly at low speeds.
  2518.  
  2519.       As of this writing, the Goldstar GM82C550  and National NS16550AN and
  2520.       NS16550FAN are the only plug compatible chips that are known to work.
  2521.  
  2522.       The Hayes ESP board comes with two serial ports with NS16550A devices.
  2523.       The ESP definitions for COM3 and COM4 agree with the industry standard
  2524.       definitions used by Omen Technology.
  2525.  
  2526.       The following information comes from a number of people:
  2527.  
  2528.       "I have located a small dealer in New York who has the cards with or
  2529.       without the 16550.  I believe the price is around $50.00.  The company
  2530.       is RJK Consulting and the number is 718-968-9167. The gentleman to
  2531.       speak to is a Mr. RJ Kulman. ...  I got this information off the
  2532.       "Interlink" BBS system." Fm: Nick Braak [TRICON] 75156,1254
  2533.  
  2534.  
  2535.       (C) 1990 Omen Tech Inc                Chapter 7 Hardware Compatability
  2536.  
  2537.  
  2538.       DSZ Manual Addendum                                 Line Printer Draft
  2539.       42                                              Hardware Compatability
  2540.  
  2541.       Fry's - 415-770-FRYS.  This is a Silicon Valley electronic department
  2542.       store.
  2543.  
  2544.       Jameco Electronics at 415-592-8097 sells National NS16550AN chips mail
  2545.       order (credit card) in small quantities.  Unfortunately, we have
  2546.       received a number of reports that their serial i/o card is now
  2547.       supplied with the infamous WD16C550 soldered in, even when ordered
  2548.       with specific instructions to include 16550AN chips.
  2549.  
  2550.       Microprocessors Unlimited, 24000 South Peoria, Beggs, OK. (918) 267-
  2551.       4961. The price for the chip is $13.50 plus shipping costs. No minimun
  2552.       purchase is required.
  2553.  
  2554.       Consolidated Computers 4 Shoppers Lane Suite 121 Turnersville, NJ
  2555.       08012 (609)751-9595(voice) (609)751-3843(bbs) (609)751-3840(fax)
  2556.  
  2557.       Arrow Electronics at 800-932-7769 (516-467-1000).
  2558.  
  2559.       Willies Computer Software Company: 800/835-4832.
  2560.  
  2561.       N.B.: Current Western Digital WD16C550 chips do not function properly
  2562.       at low speeds.  This has been confirmed with samples received directly
  2563.       from Western Digital.  WD is aware of this problem, but has not
  2564.       informed us of a corrected chip.
  2565.  
  2566.  
  2567.       7.3  Software Compatibility
  2568.  
  2569.       Some programs and device drivers affecting the operation of PC-DOS may
  2570.       interfere with YAM, especially when YAM is operating at high baud
  2571.       rates.  Historically, loss and corruption of data have been caused by
  2572.       memory resident programs.  Some of these programs increase interrupt
  2573.       latency preventing YAM from reading a character from the UART holding
  2574.       register before the next character comes in on top of it.  In other
  2575.       cases, programs do not properly restore the state of the machine when
  2576.       they exit from interrupts.
  2577.  
  2578.       If such a problem is suspected, run YAM without any memory resident
  2579.       programs or special drivers to locate the source of the problem.  Once
  2580.       the offending program is identified, a call to the program's vendor
  2581.       may obtain a corrected version.
  2582.  
  2583.       The design of memory resident programs is a little known black art.
  2584.       Subtle bugs, non reproducible interactions, and magic combinations are
  2585.       commonplace results of attempts to impose various aspects of
  2586.       multitasking on top of an operating system that was not properly
  2587.       designed to permit such extensions.  Omen Technology Incorporated may
  2588.       be able to help identify these interactions if provided with the
  2589.       source code of the offending programs.
  2590.  
  2591.       Some of the known troublemakers are mentioned below.
  2592.  
  2593.  
  2594.       (C) 1990 Omen Tech Inc                Chapter 7 Software Compatibility
  2595.  
  2596.  
  2597.       DSZ Manual Addendum                                 Line Printer Draft
  2598.       Software Compatibility                                              43
  2599.  
  2600.       TOPDOS TOPDOS, ver 2.00i by Frontrunner Development Corp., has caused
  2601.         ZCOMM and other programs to lock up.  Disabling TOPDOS restores
  2602.         normal operation.
  2603.  
  2604.       DOS 3.2 DOS 3.2 introduces the concept of a fixed number of interrupt
  2605.         stacks.  The default value chosen is not always sufficient, and DOS
  2606.         3.2 sometimes prints the infamous Internal Stack Failure message and
  2607.         cheerfully halts the computer.  Adding the line STACKS=20,128 to the
  2608.         CONFIG.SYS file should correct the problem.  Lacking any useful
  2609.         documentation from Microsoft, you may wish to experiment with
  2610.         different values.
  2611.  
  2612.       Extended Memory RAMDISKS Extended Memory electronic disks (ramdisks)
  2613.         require the 80286 chip to switch in and out of protected mode during
  2614.         block transfers.  A hardware reset pulse is used to switch back to
  2615.         the "real mode" required for DOS.  This causes loss of modem data at
  2616.         high speeds.
  2617.  
  2618.         It may be possible to reduce excessive interrupt latency by reducing
  2619.         the length of protected mode block transfers to 128 or less.  In one
  2620.         instance, replacing the ROM BIOS with a newer version increased the
  2621.         maximum transmission speed without losing characters to 9600 bps.
  2622.  
  2623.         This problem has not been observed with expanded memory
  2624.         (Intel/Lotus/AST/etc.) ramdisks.
  2625.  
  2626.         The new generation NS16550AN or 82510 serial interface circuits
  2627.         should be used instead of 8250's for best results at high speed.
  2628.         The NS16550AN allows extended memory operation at a communications
  2629.         speed of 115200 bps compared to 9600 bps for the 8250 and 16450.
  2630.  
  2631.       Disk Drivers Disk drivers, especially hard disk drivers for 80286
  2632.         machines, lock out interrupts for varying periods of time.  The
  2633.         actual interrupt latency depends on the speed of the computer and
  2634.         the particular BIOS code used.  In one case, upgrading to a newer
  2635.         BIOS allowed operation at 38400 bps, compared to 4800 bps
  2636.         previously.  Such an improvement is well worth the small ($25
  2637.         typical) cost of a new set of ROM BIOS chips.
  2638.  
  2639.       DOS 3.x Each new version of PC-DOS adds new features and eats up more
  2640.         of the 8088's meager resources.  DOS 3.2 increases interrupt latency
  2641.         enough to interfere with YAM's operation at 19200 bps on an IBM PC.
  2642.         If this is a problem, switching to DOS 2.1 will reduce the interrupt
  2643.         latency.  Replacing 8250 and 16450 serial interface chips with the
  2644.         new NS16550AN chip allows YAM to operate smoothly at high speeds.
  2645.  
  2646.       FANSI-Console Versions of this program before 1.07 did not maintain
  2647.         the pointer to the active display board in the IBM documented memory
  2648.         location.  A DOS mode command may cause YAM to reference the wrong
  2649.         display adapter address.  This caused incorrect sync signals and
  2650.         possible damage to certain monitors.  Current versions (2.X)
  2651.  
  2652.  
  2653.       (C) 1990 Omen Tech Inc                Chapter 7 Software Compatibility
  2654.  
  2655.  
  2656.       DSZ Manual Addendum                                 Line Printer Draft
  2657.       44                                              Software Compatibility
  2658.  
  2659.         increase interrupt latency enough that the serial line drops
  2660.         characters when the keyboard is touched.
  2661.  
  2662.       Seaware Batch Versions of this program has been known to cause loss of
  2663.         data.
  2664.  
  2665.       Spotlight/Lotus Metro This TSR program has been reported to cause
  2666.         Pro-YAM to lock up.
  2667.  
  2668.       Pathname Modifiers Programs such as FILEPATH and GLOBALS allow files
  2669.         to be visible in more than one directory at a time.  Such programs
  2670.         may interfere with security when YAM is restricted, since that
  2671.         security is based on restricting access to directories.  In general,
  2672.         sensitive files should not be made global when YAM is made
  2673.         accessible to outside callers.
  2674.  
  2675.         Pro-YAM may not recognize file names generated by such programs
  2676.         unless the program traps the DOS FINDFIRST calls as well as the file
  2677.         open calls.
  2678.  
  2679.         We have received various reports of strange behavior which have been
  2680.         traced to filesystem modifications caused by such programs,
  2681.         including damaged file systems.  We recommend such programs be
  2682.         phased out as soon as possible, as they may not operate at all with
  2683.         future versions of DOS or distributed file systems.
  2684.  
  2685.       BRKBOX This program locks out interrupts up to 17 milliseconds while
  2686.         waiting for the vertical retrace.  For a communications program, 17
  2687.         milliseconds is a very long time, and data will be lost at speeds
  2688.         above 300 bps.
  2689.  
  2690.       CGCLOCK Programs such as CGCLOCK.COM use clock interrupts to update a
  2691.         time display on the screen.  Some increase interrupt latency so much
  2692.         that YAM cannot respond in time to accept characters from the
  2693.         remote, even at 1200 baud.
  2694.  
  2695.       Concurrent PC-DOS YAM runs under Version 4.1 of Digital Research
  2696.         Concurrent PC-DOS (CPCDOS).  The - numeric parameter must be set to
  2697.         0.  The CPCDOS "addmem" command should be used to allocate extra
  2698.         memory if DOS Gateway are to be used.
  2699.  
  2700.       ANSI.SYS YAM uses direct keyboard input from the ROM BIOS because the
  2701.         DOS keyboard input calls do not handle Ctrl-BREAK properly.  As a
  2702.         side effect, keyboard keys redefined by ANSI.SYS have no effect on
  2703.         YAM's operation.  It is possible to program some of the keys to call
  2704.         YAM with arguments.  The following file, reassigns ALT-C, ALT-H, and
  2705.         ALT-V to execute the commands shown below.  The $ character
  2706.         represents ESCAPE.
  2707.  
  2708.               $[0;46;"cd \tmp";13;"YAM call -200 cbbs-r";13p
  2709.               $[0;35;"YAM call host";13p
  2710.  
  2711.  
  2712.       (C) 1990 Omen Tech Inc                Chapter 7 Software Compatibility
  2713.  
  2714.  
  2715.       DSZ Manual Addendum                                 Line Printer Draft
  2716.       Software Compatibility                                              45
  2717.  
  2718.               $[0;47;"cd \tmp";13;"YAM call cissig";13p
  2719.  
  2720.         YAM uses the ROM BIOS CRT functions and direct output to the
  2721.         display, bypassing any processing provided by ANSI.SYS.  Perhaps
  2722.         someday Microsoft will enhance ANSI.SYS to make it useful for
  2723.         programs like YAM ...
  2724.  
  2725.       PRINT.COM Once the DOS PRINT program is memory resident, file
  2726.         downloads at high speeds (38kb on a PC) suffer from interference,
  2727.         even if a file is not currently being printed.
  2728.  
  2729.         With certain printers, the DOS PRINT command will preempt the
  2730.         running program for several seconds at a time.  These "swapouts" can
  2731.         be confusing when you are accessing an interactive application.
  2732.         They may interfere with file transfers, especially if the remote
  2733.         program uses "tight" timing.  If this happens, PRINT should be
  2734.         suspended during file transfers.  Operation of the PRINT command
  2735.         does not appear to cause loss of data downloaded from timesharing
  2736.         services at 1200 bps, as long as the interruptions last less than
  2737.         ten seconds.  Perhaps IBM or Microsoft will someday fix this bug in
  2738.         the DOS PRINT command.  PRINT should not be invoked from YAM for the
  2739.         first time as DOS memory allocation will become fragmented.
  2740.  
  2741.         If PRINT or some other spooler is outputting to a serial port using
  2742.         the BIOS INT 14h serial port driver, YAM's "!~subprogram" command
  2743.         will redirect the printer output to the remote and thus should be
  2744.         avoided.
  2745.  
  2746.       SWITCHAR = -  YAM will work properly when the DOS switch character is
  2747.         set to "-", allowing Unix style pathnames.  The - numeric parameter
  2748.         must be set non zero to allow YAM DOS Gateway to use / to delimit
  2749.         directories.
  2750.  
  2751.         It may be necessary to remove this line from CONFIG.SYS and reboot
  2752.         DOS before using the IBM dump and restore commands.
  2753.         N.B.: DOS 3.0 does not support SWITCHAR in the config.sys file.  A
  2754.         short program, DASH, will set switchar to -.  It prevents many
  2755.         oaths.  Microsoft has removed all SWITCHAR support in DOS 5.0.  So
  2756.         much for POSIX compliance.
  2757.  
  2758.  
  2759.       This manual is Copyright 1991 Omen Technology Incorporated, All Rights
  2760.       Reserved.
  2761.  
  2762.       It was formatted 9-4-91.
  2763.  
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.  
  2771.       (C) 1990 Omen Tech Inc                Chapter 7 Software Compatibility
  2772.  
  2773.  
  2774.